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An Overview Of Fedit Plus 


Fedit Plus is a file and disk edit utility program for the Macintosh patterned after the ZAP type 
programs available on many other systems. It is intended to be a powerful and easy to use utility 
for use by average to highly technical users. It is not intended for the uninitiated user. The 


program allows the user low level, direct access to disk volumes for both reading and updating. 


Fedit Plus is also designed to operate with hard disk drives connected to the serial, external disk or 
SCSI ports. Efforts have been made to test Fedit Plus with as many varieties of hard disk as 
possible, but no warranty can be provided that it will operate with all disks. In particular, hard 
disks — through Appletalk may experience some difficulties, particularly when operating in 
volume mode. 


Some words of caution are in order. Careless use of this program can seriously damage a file or 
disk. If you need to modify data on a disk, and you can do so with a more secure program, then 
you should not use Fedit Pius to make the modifications. Fedit Plus has no protection to prevent 
you overwriting critical system areas of the disk such as the Volume Allocation Table and the disk 
directory, and you cannot undo changes once they have been written to disk. 


I would suggest that you follow these two strategies when using Fedit Plus: 


° Make absolutely sure that you have at least one backup copy of the disk 
you are intending to modify. This may seem like an elementary precaution, 


but it is surprising how often it 1s omitted. It really does seem that there is 


no substitute for experience when learning this lesson. 


° When writing modified data to a disk, always check your changes twice. 
Then check them again. You cannot undo changes that you make after 
they have been written to disk. If you are unsure that the changes you are 
making are correct, then don't commit them to disk. It isn't only marriage 
that presents an opportunity to do something in haste and repent at leisure. 
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An Overview of the Physical Disk Structure 


The diagram below shows the basic structure of a Macintosh diskette. The Macintosh disk drives 
are unusual because they access different portions of the disk at different motor speeds (this is the 
cause of the varying pitch of the single sided disk drive motor while accessing diskettes). 


Each diskette is formatted into 80 tracks, and each track is divided into a number of sectors. The 
sector count in any given track varies according to the position of the track on the disk. Since the 
outer tracks are longer, they can contain a larger number of sectors. Because the speed of the disk 
surface passing under the disk head must be kept within fairly close tolerances, it is necessary to 
vary the rotation speed of the disk according to which track is being accessed. The speed is lower 
for the outside tracks getting progressively higher as the disk head moves towards the center of the 
disk. 


8 sectors 
9 sectors 
10 sectors 
11 sectors 


12 sectors 





To simplify matters somewhat, the diskette is divided into 5 bands. Each band 1s 16 tracks wide 
and has a varying number of sectors in each track as shown in the diagram. By convention, track 1 
is at the outside of the diskette and track 80 is closest to the center. 


Double sided disks follow the same principles as above except that both sides of the disk are used 


to store data. Head 0 (corresponding to the only head on a single sided disk) 1s on the underside of 
the disk as it is presented to the drive, and head 1 is on the top side of the disk. 
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Each sector on a floppy diskette contains 512 bytes of data plus 12 bytes of tag information. The 
tag data can be used for recovering data accidentally erased or lost on damaged disks. The format 
of this data is described later in this manual. 


From the above data we can draw the following table: 


m | x 
1 







Sectors/Track 
| ss | ns 


12 24 
2 11 22 192-367 
3 10 20 368-527 
4 9 18 528-671 
5 8 16 672-799 


Thus a total of 409,600 bytes can be stored on a single-sided diskette and 819,200 bytes can be 
stored on a double sided diskette. 








384-735 
736-1055 






1056-1343 





1344-1599 





Not all the data area on a diskette can be used for data. Specific portions of the disk have been put 
aside for the data structures that enable data to be stored and retrieved from the disk. These struct- 
ures are discussed later in this manual. 


Hard Drives 


Hard disks come in many varieties from a number of different manufacturers. They vary in size 
from 5 megabytes to 125 megabytes or larger. They can be connected to your Macintosh through a 
serial port, the external disk port, the SCSI port of a Macintosh Plus or through an AppleTalk 
network. Fedit Plus supports all these disk types except for disks connected through AppleTalk. 


The physical layout of a hard disk volume varies according to size, type and manufacturer. There 
is no standard layout. One of the differences between hard disks and floppy disks is the treatment 
of tag bytes. Most manufacturers do not support tag bytes on each sector. The Apple Profile and 
Widget hard disks on the Macintosh XL support 12 bytes of tags, and the Hard Disk 20 supports 
20 bytes of tags. The layout of these tag bytes is described in detail later in this manual. 


Hard disks are often segmented into a number of logical volumes. Each volume has its own 


directory of files and its own space to manage. Each of these volumes is considered a separate 
volume by the Macintosh operating system and by Fedit Plus. 
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Logical Structure of File Volumes 





When the Macintosh was introduced, each disk volume was organized as a number of files with no 
particular structure. The disk directory consisted of a number of files in a simple unordered list. 
When hard disks were introduced this organization was found to be inadequate; different packages 
would use files of the same name but with different content, the time taken to search for files 
became excessive, and so on. As a result Apple introduced a hierarchical file system with the files 
in it organized rather like a tree structure. This was given the imaginative name of the "Hierarchica! 
File System" to distinguish it from the orginal "Macintosh File System" with flat directories. These 
disk structures are described below. The terms HFS and MFS are used to describe the different 
systems. 


The two systems share a number of concepts. Each disk volume contains a file directory that 
contains information describing the files on the disk. The volumes are formatted into sectors each 
containing 512 bytes of data. Files are stored on disk in units called allocation blocks, and each 
allocation block contains a multiple number of sectors. The size of an allocation block is deter- 
mined at the time the volume is initialized, and is fixed for the lifetime of the volume. 





The Macintosh File System 





This is the original system of disk organization with flat directories. Older Macintosh systems only 
know about this type of organization, and initialize all disks with an MFS directory structure. 
Newer systems which have the 128K ROM version of the file manager will only initialize single 
sided diskettes with an MFS directory. Under this system, the placing of files into folders has no 
effect on the actual disk structure. 


As mentioned earlier, each single sided disk holds 409,600 bytes of information, but not all this 
area can be used for data. Specific portions of the disk are put aside for the data structures that 
enable data to be stored and retrieved from the disk in an orderly manner. These areas include: 


Bootstrap loader 2 sectors 1024 bytes 
Volume Access Tabie 2 sectors 1024 bytes 
Disk directory 12 sectors 6144 bytes 
Alternate Master directory 2 sectors 1024 bytes 


After the spaces for these areas is deducted, about 400,000 bytes is left for data storage. In the 
Finder prior to version 5.0, the references to space used and space available were also in terms of 
"K Bytes" where 1K bytes was equal to 1000 bytes. Since version 5.0 this has been changed to 
use the more usual value of 1024 bytes for 1K. 


The volume map, overleaf, shows the various areas of a single sided diskette, and where they are 
normally located. Some areas (volume bootstrap and the volume information) have fixed locations, 
but other areas (like the disk directory) are capable of being moved to another place on the disk. 


The diagram below shows the layout of a single sided MFS diskette. 
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MFS Volume Map 
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MFS Volume Bootstrap 


Disk sectors zero and one contain the boot code if the volume is capable of bootstrapping the 
system. These sectors are the same for both MFS and HFS and are described later in this manual. 


MFS Volume Information Table 


The volume information table is contained in the first 64 bytes of sector 2 on every properly 
initialized volume. It is written to the disk when the volume is initialized. 
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The layout of this table is as follows (addresses are in hexadecimal): 


0000 $D2D7 - the ASCII equivalent is "RW" with the high bit set on, in 
good Apple 2 tradition. This stands for Randy Wiggington. These 
two bytes serve as a signature to identify this block. 

0002 The date and time of volume initialization in the standard format: the 
number of seconds since midnight on January 1st., 1904 (4 bytes). 

0006 The documentation describes this field as the date and time of the 
last backup. Actually, it is the date and time that the volume was 
last changed or updated (4 bytes). 

000A The volume attributes (2 bytes). If bit 14 is set, this volume is 
copy protected. 

000C The number of file entries in the disk directory (2 bytes). 

000E The starting sector number for the disk directory. Normally equal 
to 4 on a standard diskette (2 bytes). 

0010 Number of sectors that the file directory occupies (2 bytes). 

0012 Total number of allocation blocks on the volume (2 bytes). 
Allocation blocks are described below. 

0014 Size of each allocation block in bytes (4 bytes). 

0018 Allocation clump size in bytes (4 bytes). See below. 

001C Sector number of first sector in the volume data area (2 bytes). 

001E The next unused file number (4 bytes). See below. 

0022 The number of unused allocation blocks on the volume (2 bytes). 

0024 The length of the volume name (1 byte). 

0025 The volume name in ASCU characters (27 bytes). 


In talking about the volume information, it is necessary to describe in more detail how sectors are 
allocated to files on a volume. 


The allocatable space where the file contents are stored is divided into a number of allocation blocks. 
Each allocation block is a multiple number of 512 byte sectors. On a standard MFS floppy disk the 
allocation block size is 1024 bytes or 2 sectors. For reasons described below the allocation size on 
MFS hard disks is usually considerably larger (8 to 20 sectors are typical sizes). 


An allocation block is the minimum amount of disk space that can be allocated to a file. All space is 
allocated and dealiocated to files in terms of allocation blocks exclusively. The volume clump size 
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specifies the amount of space (in bytes) for file allocation. The clump size must be a muluple of the 
allocation blocksize. When a file is first written, MES allocates an amount of space equal to the 
clump size to that file. If the size of the file becomes so large that this space is insufficient then 
another space of clump size bytes is allotted to the file. When the file is eventually closed, MFS will 
deallocate any allocation blocks not used at the end of the file. 


An example might help. The usual size for the clump size is 8K bytes (16 sectors), and for the 
allocation blocksize 1K bytes (2 sectors). When an application program opens an output file, the file 
will be allocated 16 sectors on the disk. Assume that the application then writes 700 bytes to the file 
and closes it. The allocation blocks that contain data (in this case only the first) will remain allocated 
to the file, but the File Manager will deallocate the space for the remaining 7 allocation blocks that 
were unused. The file entry for that file will show a physical end of file at byte 1024 (the first byte 
after the end of the allocation block), and a logical end of file after the 700 bytes that were written by 
the application. 


Unfortunately for us humans (or at jeast non-computers), a number of fields are expressed in terms 
of allocation blocks rather than absolute sector numbers, so it may occasionally be necessary to 
understand how to translate one to another (although Fedit Plus will convert the fields in the volume 
and file headers for you). The relationship is: 


STNR = (BKNR - 2) * ABSZ DIV 512 + FSTN 


where STNR is an absolute sector number, 
BKNR is an allocation block number, 
ABSZ is the size of each allocation block in bytes, 
FSTN is the number of the first sector in the data space. 


The last two quantities are taken from the volume information table. 


When a file is created on a volume, that file is given a file number. The principal use for the file 
number on MFS volumes is in file and volume reconstruction. You may recall from earlier in this 
discussion that the tag data on each sector contains the file number of the file to which it belongs. 
File numbers are never reused, and since 32 bits have been allocated to hold them, it is unlikely that 
they will ever wraparound. 


MFS Volume Allocation Map 


The Volume Allocation Block Map starts at byte 64 on sector 2 of the volume (immediately after the 
Volume Information Table) and continues for as many sectors as are required. There is one entry in 
the block map for each allocation block on the volume. 


Each entry is 12 bits in size. It indicates whether the allocation block is used or unused. If the block 
is in use, the value is a pointer to the next allocation block in the file. A value of 1 indicates that this 
is the last allocation block in the file, and a zero value indicates that the block is unused. Because of 
the special values attached to zero and one, the first allocation block on a volume is number 2. 


As an example, if you assume that a file is resident in allocation blocks 5, 9 and 12 of a volume, and 


that there are no other files present. The first few entries in the volume allocation block map would 
look like this: 
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0099000 12001000 0 


The file entry in the disk directory has a field pointing to the first entry in the block map for the file. 
In the above case, it would have a value of 5. 


The size of the volume allocation map is dependent on the number of allocation blocks on the disk. 
For example, a 5 megabyte Profile disk initialized under MacWorks has a four sector map using an 
allocation block size of 4K bytes (8 sectors). This will give an average wastage of 2K bytes per file. 
If the allocation block size had been set to 10K bytes, the volume allocation map would be 2 sectors 
long and there would be an average wastage of 5K bytes per file. 


MFS Disk Directory 


The disk directory on standard volumes is located immediately after the last sector of the Volume 
Allocation Map at sector 4. There is also a pointer in the Volume Information Table to the starting 
sector of the directory. 


The directory contains one entry for each file on the volume. Each entry consists of a 50 byte fixed 
length portion plus a string for the filename. There are a variable number of entries in a sector, but 
no entry ever crosses a sector boundary. If a file entry will not fit in a sector itis placed into the next 
sector. If all sectors are full, then a “directory full" error is returned by the File Manager. 


On a standard disk there 12 sectors allocated to the file directory, and depending on filename length, 

each sector will probably contain 6 to 9 file entries. This suggests a maximum of 72 to 108 files on 

a diskette volume. In the unlikely event of you getting a directory full condition, it is possible that 

you may be able to overcome it by reducing the size of the filenames for entries already present on 

ve Hard disks have more space allocated for the file directory and can accomodate many more 
iles. 


There are two possible divisions in a file, called the data fork and the resource fork. These can be 
thought of as two completely separate files that share a common filename. Either or both of the 
forks may be present for any file. When an application program opens, reads or writes a file it will 
usually be dealing with the data fork. A program can also open the resource fork, but will use a 
slightly different command to do so. Both forks cannot be open at the same time. 


From the File Manager point of view, the main difference between the two forks is their 
organization. The format of the resource fork is closely defined by the Resource Manager, and the 
types of data are usually well defined also - things such as menus, fonts, icons and dialogs - all of 
which are designed to be accessed through the Resource Manager. On the other hand, the data fork 
has no defined structure and is only accessible through the File manager. 


The format of each file directory entry is as follows: 


0000 File system attributes byte. Bit 7 is always set to indicate a valid directory 
entry. Bit 6 is set if the file is copy protected (1 byte). 

0001 Version number of the file. This field is unused and should always be set to 
zero (1 byte). 
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0002 The file type of the file. This is a fcur character field with values such as 
"APPL" for an application, "TEXT" for text file (4 bytes). 

0006 The creator of the file. This is also a four character field. The values in this 
field are purely arbitrary and are used for matching applications to docu- 
ments belonging to that application (4 bytes). 

000A Finder attributes word. This field is described in detail below (2 bytes). 

000C The location of this file on the desktop. Used only by the Finder (4 bytes). 

0010 The folder within which this file resides. Used only by the Finder (2 
bytes). 

0012 The file number of this file. Each file on the disk is given a file number 
which is unique to that file. This number is present in the tag field of all 
sectors belonging to the file (4 bytes). 

0016 The number of the first allocation block in the data fork of this file. If this 
field is zero, this file has no data fork (2 bytes). 

0018 The logical end of file for the data fork. This is a count of the number of 
valid bytes between the start of the fork and its logical end of file (4 bytes). 

001C The physical end of file for the data fork. This is a count of the number of 
bytes on disk allocated to this fork of the file. It is always a multiple of 512 
bytes (4 bytes). 

0020 The number of the first allocation block in the resource fork of this file. If 
this field is zero, this file has no resource fork (2 bytes). 

0022 The logical end of file for the resource fork. This is a count of the number 
of valid bytes between the start of the fork and its logical end of file (4 
bytes). 

0026 The physical end of file for the resource fork. This is a count of the number 
of bytes on disk allocated to this fork of the file. It is always a multiple of 
512 bytes (4 bytes). 

002A The timestamp when this file was created. This is held in seconds since 
midnight on the Ist. January, 1904 (4 bytes). 

002E The timestamp when this file was last modified. This is held in seconds 
since midnight on the 1st. January, 1904 (4 bytes). 

0032 Length of file name (1 byte). 

0033 Characters of the file name (1 to 63 bytes, variable length). 


The file entry is required to start on a word boundary, so there may be one additional byte after the 
file name, and before the start of the next file entry. 
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Alternate Volume Information and Dead Space 

The penultimate sector of the volume is used to store a second copy of the volume information block 
in its virgin state when the volume was created. This alternate block is not updated, but can be 
useful for indicating the default sizes for various data areas during volume recovery. 


The last sector on the volume is never used by the file system. 





The Hierarchical File System 





This file system is used for double sided disks, hard disks connected though the SCSI port and the 
Apple Hard Disk 20. Some disks from other manufacturers support HFS, and some do not. There 
is at least one variety of hard disk where a single HFS volume can have number of MFS volumes 


within it's data space. 
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The diagram above shows the layout of a standard double sided floppy disk. As with MFS, an HFS 
volume can be divided into several parts: 


e Volume Bootstrap 

« Volume Information Block 

+ Volume Bitmap 

e Allocatable Space 

+ Alternate Volume Information and Dead Space 


HFS Volume Bootstrap 


Disk sectors zero and one contain the boot code if the volume is capable of bootstrapping the 
system. These sectors are the same for both MFS and HFS and are described later in this manual. 


HFS Volume Information Block 


Sector number 2 on the volume contains the data about the volume that has to be saved while the 
volume is dismounted (not in use). When the volume is mounted, this data is read into memory. 


The first 64 bytes of this information is very similar to the MES Volume Information Table 
described previously. The first two bytes are used to distinguish the volume type, $D2D7 for MFS 
or $4244 for HFS. 


The layout of the sector is as follows: 
0000 $4244 - the ASCII equivalent is "BD' which stands for Big Disk. 


0002 The date and time of volume initialization in the standard format: the 
number of seconds since midnight, January lst., 1904 (4 bytes). 


0006 The date and time that the volume was last modified; the number of 
seconds since midnight on January lst., 1904 (4 bytes). 


000A The volume attributes (2 bytes). 
If bit 14 of this word is set, this volume is copy protected. 
Bit 8 is the clean un-mount bit which is set by using the 
Finder Shutdown command. If this bit is set on boot, less 
checking of volume integrity is performed by the system 
and the boot is performed much faster. 


000C The number of file entries in the root directory (2 bytes). 

000E The sector number of the first sector in the volume bitmap. 
Normally equal to 3 (2 bytes). 

0010 New file allocation pointer (2 bytes). 

0012 Total number of allocation blocks on the volume (2 bytes). 
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0014 
0018 
001C 
O01E 
0022 
0024 
0025 


0052 
0054 
0058 
005C 


007C 
007E 
0080 
0082 
0086 
0092 
0096 


Size of each allocation block in bytes (4 bytes). 

Allocation clump size in bytes (4 bytes). See below. 

Sector number of first sector in the volume data area (2 bytes). 
The next unused catalog node identifier (4 bytes). 

The number of unused allocation blocks on the volume (2 bytes). 
The length of the volume name (1 byte). 

The volume name in ASCII characters (27 bytes). 

The date and time that this volume was last backed up expressed as 
i^ ua of seconds since midnight on January 1st, 1904 (4 


The sequence number of this volume in a set of backup disks (2 
bytes). 


The number of writes performed to this volume (4 bytes). 

The clump size of the extents tree file (4 bytes). 

The clump size of the catalog tree file (4 bytes). 

The number of directories (folders) in the root directory (2 bytes). 
The total number of files in all directories on this volume (4 bytes). 
The total number of directories on this volume (4 bytes). 

Finder information for this volume (32 bytes). The first four bytes 
contain the directory identifier of the folder that contains the System 
file - the "blessed" folder. The second four bytes contain the 
directory identifier of the directory that contains the startup applica- 
tion if it is not in the blessed folder. 

The size of the volume cache (2 bytes). 

The size of volume bitmap cache in memory (2 bytes). 

The size of the common cache for the volume in memory (2 bytes). 
The length of the Extent B-Tree (4 bytes). 

The extent record for the Extent B-Tree (12 bytes). 

The length of the Catalog B-Tree (4 bytes). 


The first extent record for the Catalog B-Tree (12 bytes). 


12 


HES Volume Bitmap 


The volume bitmap is stored on disk immmediately after the volume information block. The size of 
the volume bitmap is dependent on the number of allocation blocks on the disk. On a standard 
double sided floppy diskette it occupies one sector. 


The bitmap is organized as a series of bits, one bit for each allocation block on the volume. The 
most significant bit of the first word of the first sector corresponds to the first allocation block, the 
next bit corresponds to the second block, and so on. H an allocation block is not in use by a file 
then its allocation bit is set to zero, and if the block is in use the bit is set to one. 


HFS Data Space 


The space from the end of the volume bitmap to the end of the disk is available for data storage. All 
data files are placed in this area as are the Extent and Catalog B-Trees which describe the volume 
structure. 


The B-Tree structures are described later in this manual. 


Alternate Volume Information and Dead Space 


The penultimate sector of the volume is used to store a second copy of the volume information block 
in its virgin state when the volume was created. This alternate block is not updated, but can be 
useful for indicating the default sizes for various data areas during volume recovery. 


The last sector on the volume is never used by the file system. 


The Structure of HFS Data Files 


Unlike MFS, the disk directory does not occupy a specific portion of the disk but is contained in two 
files in the allocatable space of the volume. The Extents B-Tree file is used by the system to keep 
track of file mapping on the volume, a function performed by the volume allocation map under 
MEFS. The Catalog B-Tree file is used to maintain the hierarchical file structure on the disk and 
corresponds to the disk directory under MFS. 


Every file on the volume has an entry in the catalog file. As with MES, each file can contain a data 
fork, a resource fork, or both, or neither. The last case 1s an empty file which needs no further 
description. Each fork can be considered as a separate file, with no relationship between them. 
Apart from the restriction that both forks cannot be open at the same time, HFS considers them as 
independent entities on the disk that share a common file entry in the catalog. 


The primary difference between the two forks is their organization. The format of the resource fork 
is defined by the Resource Manager, and the types of data are usually well defined also - fonts, 
menus, icons and dialogs, for example - which are designed to be accessed through the Resource 
Manager. The data fork has no defined structure and is only accessible through the File Manager. 


Each fork in a file will consist of one or more extents. An extent is a contiguous area on disk that is 
allocated to a file, and is specified by a starting allocation block number and a length field indicating 
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how many allovation blocks are in the extent. If a file is contiguously on disk then it will have a 
single file extent. Access to a file is considerably faster if all the sectors in the file are contiguous, 
so the fewer extents in a file the better. 


As files are allocated space when required, and several files can be written simultaneously, the disk 
might become very fragmented if space was allocated a single block at a time. The concept of a file 
clump was introduced to reduce this possibility. Space is allocated to a file not in terms of allocation 
blocks but in file clumps. A clump is a group of contiguous allocation blocks, and therefore the 
clump size is always a multiple of the allocation block size. Since space is assigned to a file in 
clumps, the worst fragmentation of a file is into clump size pieces. To reiterate, the object 1s to 
reduce the number of file extents. 


The default size of a file clump is determined from the volume information block described above. 
An application can also specify the clump size to be used for an individual file when the file is 
created. 


The following strategy is used when searching for space to allocate to a file. When a block of a 
certain size is requested by an application, it is first rounded up to the next multiple of the clump 
size. The volume bit map is scanned forward from the block specified by the new file allocation 
pointer (in the volume information block) until a free area is found that is large enough to 
accomodate the requested block. The block is allocated at the start of the located area and the rest of 
the area is left free. The new file allocation pointer is updated to point to the location where the scan 
finished. This means the next scan for space will start where this one left off. The scan is 
unaffected by files that are deleted from lower disk addresses (until the new file pointer wraps 
around), and disk fragmentation is kept fairly low. 


If the requesting application asks for a contiguous area, and no area large enough is found, an error 
is returned to the program. However, if a contiguous area was not requested then a number of 
passes may be made though the volume bitmap to locate a number of smaller spaces that will satisfy 
the request. 


If an application requests extra space for an existing file, an attempt is made to extend the last file 
extent already allocated as far as 1s permitted by the availability of contiguous free allocation blocks. 
If this does not provide enough space to satisfy the request then a search is rnade from that point to 
locate the further space required. 


HFS File Numbers 


Each file and directory on an HFS volume is assigned a number called the Catalog Node Identifier 
(CNID) or file number. The CNID for a new file or directory is determined by adding 1 to the last 
CNID that was allocated. The next CNID to be allocated is held in the volume information table in 
sector 2. When a volume is created, this number is set to an initial value of 16. 


System nodes are allocated fixed node numbers below 16 as follows: 


The volume bitmap 

The root directory of the volume 
The Extents B-Tree file 

The Catalog B-Tree file. 


A whe 
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The Structure of HFS B-Tree Files 


File extents and the file catalog are maintained by two special HFS files which are organised as 
B-Trees. B-Trees are based on the concept of a hierarchical tree structure. Each record in the fıle 
consists of two portions; a key that is used to locate the record, and the data assigned to the record. 
Each data record is located in a file node for convenience in searching. Also part of the file are a 
number of index records that are used for speedy access to individual records. 


A B-Tree file contains of a number of nodes, and each node contains a number of records. Each 
node is 512 bytes long; the more astute will realise that this is also the length of one data sector. At 
the start of each node is a 14 byte area called the node header. The layout of a B-Tree node is shown 


below: 













Node Header 


Record 0 


Record 1 


Record 2 


Free Space 


Free Space Offset 


Record 2 offset 





Record 1 offset 
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Record 0 offset 
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The layout of the node header is as follows: 


0000 


A forward link to the next node in a sequentia] chain (4 bytes). 
This field is not meaningful for index nodes. 


A backward link to the previous node in a sequential chain (4 
bytes). This field is not meaningful for index nodes. 


The type of node (1 byte). Here are the possible types: 
0 index node 


1 header node 
2 map node 
255 leaf node 


The level of the node in the B-Tree. Leaf nodes are always at level 
1, the first level of index nodes above them are level 2, and so on 
up to the header node (1 byte). 

The number of records currently located in this node (2 bytes). 


An unused field (2 bytes). 


Following the node header are a number of variable length data records. At the end of the node are 
two byte pointers to each of these records. The area between the last record and the offset pointers 
is designated as free space. There is also a pointer to the free space at the end of the node. 


B-Tree Header Node 


The first record in every B-Tree is the header node with a node type of 1. This record always 
contains three records: the B-Tree header block, a user area, and a bitmap. When the B-Tree file is 
opened, the B-Tree header block is read into memory where it forms the nucleus of the B-Tree 
Control Block. The layout of the header node is as follows: 


000E 
0078 
OOF8 


Header block (104 bytes). 
User area (128 bytes). 
B-Tree bit map (256 bytes). 


The layout of the 104 byte header block is as follows: 


0000 
0002 
0006 
000A 
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Current depth of the B-Tree (2 bytes). 

The logical sector number of the B-Tree root node (4 bytes). 
The number of leaf nodes in the B-Tree (4 bytes). 

The logical sector number of the first leaf node (4 bytes). 
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Extents B-Tree Structure 


The Extents B-Tree contains information about each file extent on the disk. Each record contains 


information about three extents on disk, each extent being described by a extent descriptor, and is 
preceded by the record key as follows: 


0000 Length of the record key, always equal to $07 (1 byte). 

0001 The fork to which this file belongs, $00 for the data fork or $FF for the 
resource fork (1 byte). 

0002 The Catalog Node Identifier (file number) of the file (4 bytes). 

0006 The relative offset of the first allocation block that is described by the first 


extent descriptor in the record (2 bytes). 


(End of record key and start of record data) 


0008 First extent descriptor (4 bytes). 
000C Second extent descriptor (4 bytes). 
0010 Third extent descriptor (4 bytes). 


Each extent descriptor has two fields as follows: 
0000 The relative offset of the first allocation block in the extent (2 bytes). 


0002 The number of allocation blocks described in the extent (2 bytes). 


Not all extent descriptors will necessarily contain valid data. Those that do not will contain zeroes. 


Not all files have entries in the Extents B-Tree because the first three extents in each fork are specif- 
ied in extent descriptors within the file's entry in the Catalog B-Tree (described below). 


Catalog B-Tree Structure 


The Catalog B-Tree contains an entry for each file and directory on the disk as well as control in- 
formation that defines the hierarchical structure on the disk. There are three types of record in the 
Catalog B-Tree; directory records, file records and thread records. Each record is preceded by its 
key. 


As mentioned earlier, each file and directory on the volume is allocated an identifying number. This 
might be called the file number, the directory ID, the Catalog Node ID or the Cnode number, 
depending on which of Apple's documentation you are reading, but they all refer to the number that 
is assigned to the file or directory when it is created in the Catalog B-Tree. The system uses these 
node identifiers together with the file and directory names to navigate around the Catalog B-Tree. 
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Eventually the record accessed will be a leaf node which is then searched for the required record. If 
the record is not located in the leaf node, it 1s not in the file. 


This is a fairly complex structure. An insertion or deletion can result in index nodes being split or 
removed from the file. An operation such as moving a large number of files into, out of or between 
directories can result in a substantial number of sectors in the Catalog B-Tree being changed. 


B-Tree Leaf Node 


The leaf node is the only type of node that actually contains data records. Each record in a leaf node 
is laid out as shown below: 


Record Key Record Data Area 
(4 to 254 bytes) (4 to 502 bytes) 


The key fields and the data fields are considerably different in the Extents B-Tree and the Catalog 
B-Tree so each will be described in turn. 
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Key=1,'VoluməName' 


=. Parent Key=1 ‚Vol umeName' 


Directory record (root) 






Thread record 





Key=2,'Desktop' 


File record 





pure i Key=2,'Directory1' 


Key=2,'FileNamet' 
FilelD=18 


Parent Key=2,'Directory1' 


Key=17,.'Filename2' 


Directory record 





File record 










Thread record 





File record 





Key=17,'Filename3' 


FilelD=20 


File record 


All the records in the Catalog B-Tree share a standard format for their key, the directory identifier of 
their parent concatenated with their node name. 
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In the Finder display, direciones are shown as folders, and can be opened to show other directories 
and files that are enclosed in each folder. The following diagram shows a tree structure respre- 
senting a volume called VolumeName with one directory called Directory1, three user files and the 
Desktop file. Two of the files are enclosed in Directoryl. The numbers inside each node are the 
Cnode identifiers for each entity. 





Filename2 Filenames 


If you examine the node records of a Catalog B-Tree containing the above structure you would see 
two directory entries (for nodes 2 and 17) and four file entries (for nodes 16, 18, 19 and 20). In 
addition there would be two thread records, one associated with each directory record. The root 
directory for every volume always has a node identifier of 2. 


Every node has a parent node which is defined as the node immediately above it in the hierarchy. 
The root node would appear from the above diagram not to have one, but in fact the parent node of 
the root directory is a non-existent node with a node identifier of 1. 


Every node in the Catalog B-Tree has a key which is defined as the node identifier of its parent plus 
the name of the node, for example, the key for the Desktop file would be 2, DeskTop'. Pathnames 
are defined by concatenating node names together separated by colons, for example, the pathname 
for Filename2 would be 'Volumename:Directory 1:Filename2’. 


As mentioned previously, there 1s one thread record in the Catalog B-Tree for every directory 
record. All directory and file records that have a common parent are given contiguous entries in the 
Catalog B-Tree. Preceding these records is a thread record which specifies the key of the parent 
node, that is, provides a link to the parent, thus allowing a backwards chain from any file record 
through each parent directory to the root directory. 


The diagram on the next page shows the linkages that would be found for the Catalog B-Tree whose 
diagram is shown above. 
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0012 
0014 
0018 
001A 


001E 


0022 
0024 


0028 


002C 


0030 


0034 
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The creator of the file. This is also a four character field. The values in this 
field are purely arbitrary and are used for matching applications to docu- 
ments belonging to that application (4 bytes). 

Finder attributes word. This field is described in detail below (2 bytes). 
The location of this file on the desktop. Used only by the Finder (4 bytes). 
The number of the directory identifier in which this file resides (2 bytes!!). 
The node number of this file entry (4 bytes). 

Unused bytes set equal to zero (2 bytes). 


The logical end of file for the data fork. This is a count of the number of 
valid bytes between the start of the fork and its logical end of file (4 bytes). 


The physical end of file for the data fork. This is a count of the number of 
bytes on disk allocated to this fork of the file. Itis always a multiple of 512 
bytes (4 bytes). 

Unused bytes set equal to zero (2 bytes). 

The logical end of file for the resource fork. This is a count of the number 
of valid bytes between the start of the fork and its logical end of file (4 
bytes). 

The physical end of file for the resource fork. This is a count of the number 
of bytes on disk allocated to this fork of the file. It is always a multiple of 
512 bytes (4 bytes). 


The timestamp when this file was created. This is held in seconds since 
midnight on the 1st. January, 1904 (4 bytes). 


The timestamp when this file was last modified. This is held in seconds 
since midnight on the 1st. January, 1904 (4 bytes). 


The timestamp when this file was last backed up. This is held in seconds 
since midnight on the 1st. January, 1904 (4 bytes). 


Additional space for use by the Finder (16 bytes). 


The clump size of this file. Set equal to zero if the volume default size 1s to 
be used (2 bytes). 


The first extent descriptor for the data fork. Zero if unused (4 bytes). 
The second extent descriptor for the data fork. Zero if unused (4 bytes). 
The third extent descriptor for the data fork. Zero if unused (4 bytes). 
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The layout for each Catalog B-Tree key is as follows: 


0000 The length of the key in bytes (1 byte). 

0001 One unused byte, always zero (1 byte). 

0002 The directory identifier of the parent directory for this entry (4 bytes). 
0006 The name of this entry in Pascal string format (up to 32 bytes). 


There may be one additional byte following the key to make the total length of the key an even 
number. Sometimes this extra byte is included in the key length and sometimes it isn't!! 


A directory record has the following data following its key: 


0000 The directory record signature of 1 (1 byte). 

0001 A single byte equal to zero (1 byte). 

0002 The Finder flags for the directory entry. Not all the flags defined for files 
are valid for directories, but you can achieve some interesting effects by 
setting them. For example, invisible directories (2 bytes). 

0004 The number of file and directory entries that are contained in the hierarchical 
level directly below this directory. This is sometimes referred to as the 
entry's valance (2 bytes). 

0006 The node identifier for this entry (4 bytes). 

000A The timestamp when this directory was created. This is held in seconds 
since midnight on the 1st. January, 1904 (4 bytes). 

000E The timestamp when this directory was last modified. This is held in 
seconds since midnight on the 1st. January, 1904 (4 bytes). 

0012 The timestamp when this directory was last backed up. This is held in 
seconds since midnight on the 1st. January, 1904 (4 bytes). 

0016 Bytes for use by the Finder (32 bytes). 

0036 Unused space (16 bytes). 


0000 
0001 
0004 
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A file record has the following data following its key: 


The file record signature of 2 (1 byte). 
Unused bytes set equal to zero (3 bytes). 


The file type of the file. This is a four character field with values such as 
"APPL" for an application, "TEXT for text file (4 bytes). 
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Tag Data 
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Each data sector when on disk consists of two portions, the data itself plus 12 bytes of tag data. The 
declared purpose of the tag data is to assist in the reconstruction of damaged disks. The tag data 
consists of the following areas (addresses are in hexadecimal): 


0000 The number of the file to which this sector is allocated (4 bytes). 


0004 Fork Indicator. If bit 1 of this byte is zero the sector belongs in the data 
fork, otherwise it is located in the resource fork (1 byte). 


0005 For MES volumes, the version number of file that last wrote this sector. On 


HES volumes this field forms part of the following field to form a 24 bit 
relative sector number (1 byte). 


0006 Relative sector number of this sector within its fork (2 bytes). 

0008 Timestamp set when this sector is written to disk in seconds since midnight 
on January 1st., 1904 (4 bytes). 

000C Creator of the file as specified in the file's entry in the HFS disk catalog (4 
bytes). 

0010 The HFS directory identifier of the catalog entry which is the parent of the 


file in which this sector resides (4 bytes). 


The last two fields are only applicable to HFS, and are only found on hard disks that support the 20 
byte tag fields. 


Most non-Apple produced hard disks do not support tags. In these cases the tag data fields are 
ignored on both input and output. 
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The Volume Bootstrap 


The first two sectors on each volume are reserved for a volume bootstrap loader. These sectors are 
read into memory whenever an attempt is made to boot the Macintosh from that disk. 

„hoot sectors are the same for both MFS and HFS. The first part of the sector zero is data defining 
some of the standard system names and sizes and the rest is code to get the system running. 


The layout of the data areas at the start of sector zero are as follows (addresses are in hexadecimal): 


0000 $4C4B - LK' in ASCH, for Larry Kenyon - the principal architect of the 
file system. 
0002 A branch to the code starting point (4 bytes). 
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0056 The first extent descriptor for the resource fork. Zero if unused (4 bytes). 


OOSA The second extent descriptor for the resource fork. Zero if unused (4 
bytes). 

OOSE The third extent descriptor for the recource fork. Zero if unused (4 bytes). 

0062 Unused space set to zero (4 bytes). 


A thread record has the following data following its key: 


0000 The thread record signature of 3 (1 byte). 
0001 Unused bytes set equal to zero (9 bytes). 
000A The directory identifier of the parent of the file entries which follow this 


record in the catalog (4 bytes). 


000E The name of the parent of the file entries which follow this record in the 
catalog (always 32 bytes, zero filled on the right). 
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number of the boot blocks to a value $0015. This will cause the values in the bootstrap sector to 
override the values in ROM. 


If you wish to force the system to call the boot block code as a procedure during the system boot 
process, you should set the value of the version number to 


nn nm 
The Finder Flags 
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This is a two byte area in the directory entry for each file on both MFS and HFS volumes. The flags 
in this field describe various attributes of the file to the Finder. The meanings of each bit (starting 
from the left) is as follows: 


15 Locked. This bit is set if the file is locked. 
14 Invisible. This bit is set if the file is not to be displayed by the Finder. 
13 Bundle. This bit is set if the file has one or more icon lists, file references 


or version data. If a file entry has this bit set, the Finder will copy this 
information into the "desktop" file that it maintains on each disk. The most 
common reason for setting this bit is to get the Finder to recognize 
non-standard icons. 


12 System. This bit is set if the file is a system file. 

11 Bozo. This is a protection scheme so simple, only a bozo would be 
deterred by it. 

10 Busy. Set if the file is currently busy. 

9 Changed. The file has been changed, and needs to be updated on disk. 

8 Inited. The file has been seen by the Finder and allocated a location in its 
assigned folder. 

7 Shared. Indicates that the file is open by multiple applications for shared 
access. 

6 Cached. This bit is currently unused. 

5 On desk. Specifies that this file is on the desktop, not in its folder. 

á Always switch launch. Normally, when the boot volume js a hard disk and 


an application on another disk is launched, the hard disk remains as the boot 
volume. When this attribute is set, launching the file will always cause the 
volume on which it resides to become the boot volume provided there is a 
valid system and Finder file on the disk. 


The remaining bits in this word are not currently used. 
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0006 The version number of the bootblocks (2 bytes) - see below. 


0008 Page flags (2 bytes). 
000A Name of the system file (16 bytes). 
001A Name of program to run when exiting application (16 bytes). 
002A Name of the debugger program to use (16 bytes). 
003A Name of disassembler to use if debugger is loaded. This is pretty much 
historical only (16 bytes). 
004A Narne of the file containing the startup screen (16 bytes). 
005A Name of the first application to run after the bootstrap is completed (16 
bytes). 
006A Name of the clipboard file (16 bytes). 
007A Number of file control blocks to allocate. This field defines the maximum 
number of files that can be open (2 bytes). 
007C Max number of elements for the event queue (2 bytes). 
| | | 007E System heap size for 128K system (4 bytes). 
i 0082 System heap size for 256K system (4 bytes). 
| | - 0086 System heap size for 512K and larger systems (4 bytes). 


| 


When a disk is initialized, no boot blocks are written into sectors zero and one. In order to get this 
task accomplished, it is necessary to copy another disk onto the new disk (perhaps by dragging the 
icon for the old disk onto the new disk), copy a file called "System" from another disk of the same 
type or to use a program designed to write boot blocks such as the Disk Utility program available 
from Apple or Fedit Plus. 


Whe cutrent boot block version number (June 1986) is $0012. This is the version that is written to 
the disk by the latest version of the Apple Disk Utility program. Incidentally, there is a feature in the 
Disk Utility program that may be of use to developers using 512K systems who wish to test that 
their programs will work correctly when executed on a 128K system. sií the command and option 

ys are hel@down while the Write Boot Blocks option is selected, a:special version of the boot 

ocks is written to the disk. The effect of these blocks is to cause a 512K system to be initialized as 
if it contained only 128K of memory. If you are looking at the boot blocks using Fedit Plus, you 
can recognize this special bootstrap because it has a version number of $0014. 


On systems with 128K ROMS, the system does not boot from the bootstrap loader as it has the 
necessary code built into the ROM. One effect of this is to cause a change that you make to the size 
of the system heap or other default parameters to be ignored, as the values are taken from ROM. In 
order to make an effective change in the size of the system heap you should change the version 
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Running The Program 


As with all other Macintosh programs, Fedit Plus is run by double clicking on the Fedit icon (unless 
you are using the minifinder or another program to replace the Finder). This loads the entire 
program into memory including all system resources that may be required by Fedit Plus. After this 
load has been completed, you may remove the disk containing Fedit Plus and the system disk from 
the system as no resources should ever be required to be loaded during program execution. This is 
useful if you have a single drive system, as you will not have to perform any disk swapping in the 
middle of the program - a definite problem for a disk editor. 


When the program is first run, you are presented with four menus across the top of the screen. 
These are described in detail below. Normally, the first action you will take will either be to open a 
file or a volume from the "File" menu. When you do this, you will be presented with the first 512 
byte sector of the volume or file that you have selected. This will either be in ASCII or hexadecimal 
format depending on the default chosen in the "Configure" item of the file menu. 


ASCII Mode Display 


The ASCII format shows an entire 512 byte sector as a series of ASCII characters in 8 rows each of 
64 characters. Characters that are not valid for printing are displayed as periods. A blinking cursor 
is displayed beneath the current character, marking the insertion point. In order to change the 
position of the character cursor, you should move the mouse cursor on top of a new character and 
press the mouse button. 


Beneath the character display is a line showing the hexadecimal value of the character at the insertion 
point, the offset of the insertion point from the start of the sector, and the offset of the current sector 
from the start of the file or volume currently being displayed. 


Hexadecimal Mode Display 


In this mode, the data in a sector is displayed in hexadecimal characters with the ASCII 
representation beside them.- The current insertion point is shown by one inverted hex character. 
Because this mode requires more space, the entire sector cannot be displayed on one page. A 
vertical scroll bar on the right side of the window allows a user to switch between the first and 
second portions of the sector. At the start of the sector is displayed the sector tags and the offset of 
the sector from the start of the file or volume, both in hexadecimal. 


Changing the Current Character Position 


In both ASCII and hexadecimal display modes, the current character may be changed by moving the 
mouse pointer to the required character, and clicking the mouse. Fedit Plus also supports moving 
the current character pointer by using the cursor keys on the Macintosh Plus. The Tab key will 
move the current character pointer forward to the next multiple of eight characters in the sector, and 
the shift/tab will move the current character position backwards in the sector to a multiple of eight 
characters. 
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Using The Program 
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This concludes the description of the disk data structures. The rest of this manual describes the 
Fedit Plus program and how the various commands are used to examine and manipulate the disk 
structures. 


Fedit Plus is not a difficult program to understand, but it is very easy to misuse it and accidentally 
change data on the disk in a way that you did not anticipate. Now would be a good time to re-read 
the warnings on the first page of this manual about data security. 


Fedit Plus is essentially a disk editor. The principal difference between Fedit Plus and more 
conventional edit programs it that Fedit Plus edits data as it exists on disk without regard to its 
logical structure, and conventional editors always make some assumptions about the data structure. 


With Fedit Plus there is no concept of inserting and deleting data. As it operates on disk sectors of 
fixed size, you can only replace data in each sector. You can never increase or decrease the amount 
of data in a sector; it is always fixed at 512 bytes (plus the 12 or 20 tag bytes if supported). 


File And Volume Modes 


Fedit Plus operates in two modes - file mode and volume mode. In file mode you can open a file 
and read each disk sector that is allocated to the file. You can also examine the file entry jn the disk 
directory and make changes to some portions of that entry. In volume mode, you can read all the 
sectors in a volume without regard to which file (if any) each sector belongs. This mode is most 
useful for examining and changing the system areas of a disk such as the boot blocks, the volume 
information table and the disk directory. 


Lisa Diskettes 


If a diskette initialized by the Lisa Workshop or the Lisa Office System is placed in a Macintosh, it 
normally cannot be read. The Macintosh will give you the option of either ejecting the diskette or 
initializing it. 


If a Lisa diskette is placed in the Macintosh while Fedit Plus is running, it will report that the diskette 
was not initialized on a Macintosh and will give you the option of ejecting the disk or mounting it. If 
you choose to mount the diskette, then Fedit Plus can edit it as normal, but only in the volume 
mode. 


ASCII versus Hexadecimal display 


You may choose to display sector data either as ASCII characters only or as hexadecima! characters 
with the ASCII translation beside them. Which display you use is primarily a matter of persona! 
preference. The ASCII mode is useful because a full sector can be displayed, and it is easy to scan 
though a large number of sectors quickly. The hexadecimal display is often more useful for detail 
work on a sector. 
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consists of asking you whether you wish to initialize or eject the disk. Within the rest of Fedit Plus, 
the normal action is to describe the error condition found, and give you the choice of mounting or 
ejecting the disk. By mounting the disk, you are able to read it using the Open Volume command. 


Close 


This command closes the volume or file that is currently open. If a desk accessory is currently 
active, this is closed instead. 


Write Boot Blocks 
This command writes boot data in sectors zero and one of the volume currently open. Version 1.2 
of the boot data (see previous discussion) is always written. The data is taken from a resource in the 


Fedit Plus code file. If you wish to change the boot data written you should modify this resource. 
It is BOOT resource number 128. 


Edit Boot Blocks 

This command allows you to edit the fields in the boot blocks that define the names of the various 

system and startup files and the sizes of various system options. On a system that has the 128K 

ROMs, certain options such as the size of the event queue and the system heap size are actually taken 

from code in the ROM. It is necessary to change the version number of the boot blocks to 21 
imal $15) for the size specified in the boot blocks to override the ROM values at the time the 

system is booted. 


Delete File 


You may delete a file in the current volume using this command. 


Rename File 


You may rename a file in the current volume using this command. 


Print Sector 
This command copies the current disk sector to the system printer. The format of the sector IS 


similar to the hexadecimal display. Data related to the position of the sector in its file on the disk is 
also printed if applicable. 
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The File Menu 
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Open Volume... 
Open File... 
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lUrite Boot Blocks 
Edit Boot Blocks 
Delete File... 
Rename File... 
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Print Sector 
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Configure 
Quit 








This menu contains items applicable to file and volume opening and closing, the use of the printer. 
and some housekeeping items. 


Open Volume 

This command requests that a volume be opened for input and updating. This is most useful if yo- 

wish to examine the system areas of a disk such as the boot blocks, volume allocation tables or disx 

directory. 

When a Lisa disk or a disk with errors has been mounted, these can also be examined using the 
Volume command. In these cases Fedit Plus will not be able to determine the volume name. 

and the disks will be referenced using names such as "(Internal Drive)" and "(External Drive)". 


For hard disks that are partitioned, each partition is considered a separate volume. 


Open File 


This command is used when you wish to open a file on a volume. This calls the standard Macintos”. 
file selection dialog which passes the name of the requested file to Fedit Plus. 


One point to be aware of is that the normal system action will occur if a Lisa or other non-standa-< 
disk (or a disk with directory errors) is inserted while the file selection dialog is active. This actor 
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The Edit Menu 












Read Next Sector 
Read Prev Sector #P 
Read Sector... 
Write Sector 96 LU 
Write Extended... E 















ASCII Modify 
Hex Modify 


This menu contains items relating to the selection of sectors for editing, the type of edit to use, 
discarding changes and writing changed data back to disk. 


Read Next Sector 


This command reads the next higher logical sector for the file or volume currently open. This is the 
same action that is taken if the mouse is clicked in the down arrow or down page regions of the 
horizontal scroll bar at the bottom of the display window. 


Read Last Sector 


This command reads the next lower logical sector for the file or volume currently open. This is the 
same action that is taken if the mouse is clicked in the up arrow or up page regions of the horizontal 
scroll bar at the bottom of the display window. No action is taken if you attempt to use this 
command while the first sector of the file or volume is displayed. 


Read Sector 


This command allows you to enter the number of the sector that you wish to display. The number is 
a decimal value between zero and the last sector number of the file or volume currently open. This 
action is very similar to the action taken by moving the thumb of the horizontal scroll bar at the 
bottom of the display window. 
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Configure 


This command allows you to reconfigure the default mode for displaying data (either ASCH or 

hexadecimal) and to choose the type of cursor to be used in each display mode. Six standard 

cursors are provided, but if your favorite cursor is not among them, you can modify or substitute the 

aS. cursors using a resource editor. The cursors are resource type CRSR with values of 256 to 
1. | 


The configure command also gives you some control over the input of numbers. This is how Fedit 
Plus examınes any numbers that you input to a dialog: 


if the number starts with a dollar sign ($) it is considered to be hexadecimal, 
if the number starts with a pound sign (#) it is considered to be decimal, 


if there is a hexadecimal character (A to F, or the lower case equivalents) in the number it is 
assumed to be hexadecimal, 


and if none of the above is true, the number is assumed to be decimal or hexadecimal accord- 
ing to the setting of the default in the Configure dialog. 


An occasional problem with the hexadecimal display screen is that the whole of the sector is not 
displayed at once. If you are scrolling though a file or volume you may wish to show the top and 
bottom halves of each sector in sequence to ensure that you have visually examined all the data in 
each sector. This may be done by selecting the option that allows half sector moves in this dialog. 


Characters in a file are normally displayed as their standard ASCII equivalents. Characters that are 
outside the range of $20 to $7E (space to "-") are displayed as periods. The Configure dialog also 
allows you to change this setting. Using the Extended character set, characters in the range $A0 to 
$D9 will also be displayed. If this setting does not fit your needs there is also a Custom character 
set that you can set up as you require. These three sets can be found in the code file as resource type 
FXTL numbers 256 (Standard), 257 (Extended), and 258 (Custom). 


The configure dialog also allows you to modify one of the Fedit Plus safety features. Normally each 
write to the disk has to be confirmed by you, but if you prefer this can be bypassed. This is not 
recommended unless you are confident in your abilities and never make mistakes. 


Quit 
This command allows you to exit the program. 
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In ASCII display mode, two hexadecimal characters are required to overwrite one ASCII character. 
After you have typed the first hexadecimal character, you must type another one; this is the only 
action that Fedit Plus will allow at this point. If you suddenly find that menu commands wont 
operate correctly, check that the program is not waiting for a second hexadecimal character. 


Any changes that you make to the sector are not written to disk until the Write Sector command is 
selected. 


Undo Changes 
Using this command, you can undo any changes you have made to the current sector using the Hex 


or ASCII modify commands. You will be asked to verify that you wish to revert to the original 
data. 
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Write Sector 


After a sector has been modified, you can write the sector back to the disk by selecting this 
command. After confirming that you really do wish to update the disk, the sector will be written 
back to the disk at the location from which it was read. 


Write Extended 


This command presents you with a dialog box allowing you to select a different volume and position 
to re-write the current sector. The default selection is always the original position of the sector on the 
volume currently open. The sector number is always relative to the start of the disk volume, even 
when a file is open. 


You should be very careful when using this command as there are no checks to prevent overwriting 
any portion of any disk volume on the system. This command can be very useful for reading 
portions of a disk that have been destroyed and writing them to another disk. 


ASCII Modify 


This command allows you to modify the data in the sector. When this command is active, a warning 
message is displayed in the menu bar. The command is deselected whenever a new sector is read 
from disk unless the Configure dialog has been set to always enable the command. 


Pressing any non-control key will cause the character at the current insertion point to be overwritten 
and the insertion point to be moved forward one character. If the insertion point is located at the last 
character of the sector, it is wrapped around to the first character. 


Pressing a control key (cursor key, backspace or tab) will cause the normal for that key to occur; that 
is, the position of the insertion point in the sector will be altered. 


Any changes that you make to the sector are not written to disk until the Write Sector command ıs 
selected. 


Hex Modify 


This command allows you to modify the data in the sector. It may be selected from the Hexadecimal 
or ASCII display modes. When this command is active, a warning message is displayed in the 
menu bar. The command is automatically deselected whenever a new sector is read from the disk 
unless the Configure dialog has been set to always enable the command. 


If in Hex display mode, pressing any valid hexadecimal key (0-9, A-F) will cause the character at 
the current insertion point to be overwritten and the insertion point to be moved forward one 
character. If the insertion point is at the last character of the sector, it wraps around to the be ginning 
of the sector. 


Pressing a control key (cursor key, backspace or tab) will cause the normal for that key to occur; that 
is, the position of the insertion point in the sector will be altered. 
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Tag Search 
This command allows you to search though the tag bytes of each block looking for specific patterns. 


You should refer to the layout of the tags described earlier for more details of what this command 
can do for you. 


Repeat Search 


This command repeats the last search specified, starting one character beyond the current character in 
the sector. 


Set End of File 


Using this command you can set the current end of file position to the start of the file (effectively 
creating an empty file), to be equal to the end of the physical file, or to any position in between. 


Reverse Forks 


This is a command that switches the pointers in the disk directory for the data and resource forks. It 
is as if the entire data fork of the currently open file is replaced by the resource fork, and vice versa. 
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Options Menu 









Options 
Date Fork 
Resource Fork 
Hex Search... 
ASCII Search... %S 
Tag Search... %T 
Repeat Search 
Set End of File... 

Reverse Forks 



















This menu contains various items that modify the normal progression for reading a file or volume, 
such as selecting a different fork or searching for a particular string. 


Data Fork 


This command is only valid when displaying a file. It allows you to select sectors from the data fork 
for display. If the data fork is empty, an appropriate error message is displayed. 


Resource Fork 


This command is only valid when displaying a file. It allows you to select sectors from the resource 
fork for display. If the resource fork is empty, an appropriate error message is displayed. 


Hex Search 
This command allows you to search the file or volume currently open for a specific hexadecimal 


string. Up to 32 hex characters (between 0-9 and A-F) may be specified. Spaces may also be 
included to make the string more readable, but these are ignored during the search. 


ASCH Search 


Using this command you may search for a specific ASCII string of up to 32 characters. Upper and 
lower case are considered separate characters unless the “Ignore Case" box is checked. 
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Volume Header Information 


This command intreprets the various fields in the volume header in sector 2 of the volume. The 
various fields are identified and the values are displayed in hexadecimal and decimal where appro- 
priate. Timestamps located in the header are also interpreted. 


Volume Sector Map 


This command displays a graphical interpretation of the status of each sector in the currently selected 
volume and shows which sectors on the disk are allocated to a file and which are available. This 
command is currently only available for single-sided MFS diskettes. 


Volume Directory 


The volume directory command shows selected information from the disk directory of the current 
volume. Information is presented on a sector by sector basis so that you can easily correlate 
information between this display and a direct view of the disk directory sectors. From this display 
you may select a file (by clicking the mouse on the filename), open a file (by double clicking the 
mouse on the filename, or selecting the Open button), or modify the directory attributes (by selecung 
the SetAttrs button). 


You may move forward or backward in the disk directory sectors by selecting the appropriate 
button, or return to the standard display mode by clicking on the End button. 


File Header Information 


This command is only available when displaying a file. It interprets all the fields in the disk 
directory heading (as opposed to the disk directory listing that only interprets some of the fields). 


The various fields are identified and the values are displayed in hexadecimal and decimal where 
appropriate. Timestamps in the file header are also interpreted. 


File Sector Map 
This command is only available when displaying a file. It displays the physical location of each 


sector in the current file and (if the file is on a single-sided MFS diskette) displays a graphica! 
interpretation of the same data. 


File Finder Attributes 


This command is only available when displaying a file. It allows you to update the various fields of 
the Finder attributes in the disk directory. 
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The Display Menu 
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Display 
Display Sector in Hex 
Display Sector Info dl 
Volume Header Information 
Volume Sector Map 

Volume Directory 
File Header Information 
File Sector Map 

File Finder Attributes 
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Fragmentation Index 








This menu allows you to modify the method of displaying data, or to display special areas of the 
disk. 


Display sector in Hex/ASCII 


Using this command you can switch between the hexadecimal and ASCII display modes. 


Display Sector Info 


This command gives access to extra information about the current sector. It displays the absolute 
sector number of the current sector, together with the position of the sector on the diskette in terms 
of track and sector numbers (but only if the sector is on a diskette in a Sony drive). 


The information in the data tags for the sector is also displayed, interpreted and verified. Any errors 
found are flagged. 


The file name, fork and position in the fork of the file are displayed. This can be very useful when 
reading a volume, as you can tie the data in the sector directly back to the file to which it belongs. 
On HFS volumes, a sequential search of the disk directory may have to be made to locate the 
filename and build the full pathname; this can take a number of seconds if there are many files on the 
volume. 
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Special Menu 
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Special 
Next Display Buffer d + 
Previous Display Buffer %- 
Specify Display Buffer... 36B 
Multiple Sector Read... 
Multiple Sector Write... 
Write Sectors to File... 
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Link to Data Fork 
Link to Resource Fork 
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Create File... 
Select Output File... 
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Validate Tags 
Recreate Volume Map 
Recover Deleted Files 


This menu contains items for use in special circumstances. One of the most difficult procedures in 
disk handling is recovering from disk problems. As discussed previously, the tags on each sector 
can be used for data recovery, but most hard disk manufacturers do not support tags. The items in 
this menu can help make recovery possible on these types of disk as well as on floppy diskettes. 
Unfortunately, due to space restrictions none of the items in this menu will run in a 128K system. If 
you are running Fedit Plus under Switcher you may also want to play with the partition size until 
you have the number of buffers that you require. 


When Fedit Plus is initialized, the program will allocate a number of buffers for use in storing data 
in memory. This will vary between 1 and 400 buffers depending on how much memory is available 
after making an allowance for desk accessories that you may wish to use. Using the items in this 
menu you may read data from any sector on disk into any buffer and then write the data out into 
another area of the disk or into a new file. 


A second method of file recovery without using tags is also available. This method allows you to 


select sectors and tell Fedit Plus to add them to the end of a file. This method can be more 
convenient that using buffer copies, but cannot always be used, for example if there are problems 
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Fragmentafion Index 


This command will examine the disk organization of an HFS organized volume and will report on 
the degree of fragmentation found on files on that volume. If all files on the volume have no more 
than one extent for each fork that exists then the index will be 0.00, but as forks get split into 
multiple extents the index will rise. The index actually measures the amount of fragmentation that 
occurs on each fork and combines those figures into a composite for the whole volume. An index of 
1.00 would indicate that every fork of every file had more than one extent and that the first extent of 
each fork was extremely smali - less than one percent of the fork size. 


This index is only a rough indication of the performance degradation that could occur due to 
fragmentation. It is suggested that volumes having a fragmentation index greater than 0.4 should be 
reorganized by copying all files to floppy diskettes (or another backup medium), reinitializing the 
disk and restoring the files. After this has been done the fragmentation index should return to 0.00. 
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others in Fedit Plus because it permits you to write to only par: of a sector, thus allowing great 
flexibility 1n rag data you change. By changing the current end of file pointer you can write to any 
location ın a file. 


Link to Data Fork 


This command is designed for file recovery. When invoked, the allocation block to which this 
sector belongs is linked in the Volume Allocation Table at the end of the Data Fork of the currently 
selected output file. You should note that the complete allocation block is linked in, not just the 
displayed sector. Ona standard MFS diskette this will be two sectors, but the number of sectors 
will vary on a hard disks. Typical values are between eight and twenty sectors on MFS organized 


hard disks, and one to three on HFS organized disks. 


Link to Resource Fork 


This command is exactly the same as the previous command, except the allocation block is linked 
into the resource fork of the currently selected file. 


Create File 


This command allows you to create a file on a volume. The created file is automatically selected for 
output from the Write Data command or Link commands. The file is created with the type and 
creator fields set to question marks, but these items can be changed using the Display File Attributes 
command. 


Select Output File 


This command allows you to select a file for output from the Write Sectors to File command or for 
data to be linked in using the Link to Data Fork or Link to Resource Fork commands. 


Validate Tags 


This command reads each sector that is allocated to a file and validates the various fields in the tag 
bytes. Any sectors that are found to have incorrect tags will be rewritten with corrected fields. This 
command is essential if you are using MacWorks on a Macintosh XL. This is a problem with 
current versions of the file that results in invalid tag fields being written on hard disks connected to 
the system. The tag fields are not corrected when a file is copied from a hard disk to a floppy 
diskette, so any diskette that has been used on a Macintosh XL should be considered suspect. 


‚Recreate Volume Map 
This command will totally rebuild the Volume Allocation Map and the Volume Information Table on 


a hard disk or floppy diskette using the MFS file organization. This is done by reading all the tags 
on a volume and determining the file structure from the tags. As a side effect, any files that are 
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found on the disk but are not located in the disk directory are also recovered. 


Recovered files are given a name with the format "REC.nnnnn" where nnnnn is the internal number 
of the file. The type and creator fields are given the value "????" and the logical end of file for each 
fork is set to the physical end of file. All the file system and Finder attributes are reset. You will 
have to restore the type and creator fields yourself by examining the data and determining what the 
correct values should be. 


Recover Deleted Files 
This command is very similar to the previous one, except that the volume Allocation Table is not 


rebuilt. Files are recovered in the same manner and are given the same type of names and file 
attributes. Currently this command only works for MFS organized volumes. 
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CONFIDENTIAL 


(This Beta version of Tempo is for authorized Beta testers and reviewers only.) 


Tempo 


Instructions for Beta Version 0.9K25 
November 25, 1985 


Please Note: 
This is a beta version of Tempo, the macro-producing utility for the Macintosh. It is quite 
probably full of bugs. Therefore, Caveat Emptor, Let the Beta Tester Beware, and never use 
this version on a disk that hasn't been backed-up. 

You'll be glad you didn't. 


COPY THIS DISK 
If you've just read the above caveat, then you'll know it's easy to lose valued bits on a disk, so 
before doing anything, make a temporary sacrifice of one disk. 
You could be glad you did. 


About this manual. 
With any luck, you'll hardly need to refer to these instructions. You can follow them along, 
step-by-step, but probably they will serve you more as a reference than as a guide. 

AS a beta tester, though, please send us your comments about the clarity of these 
instructions as well as the performance of Tempo. 


(01985 

Affinity Microsystems, Ltd. 
1050 Walnut Street, Suite 425 
Boulder, CO 80302 
303-442-4840 





I. Installation. 
There are two ways to install Tempo: You may use the Tempo installer, or you may simply 
copy a system containing Tempo onto other disks. 


A. Tempo Installer 
1. The Tempo installer and the System you wish to install into must be pesent in the Finder. 
(The production release installer will allow you to select consecutive systems to install 
Into.) 
2, Double-click on the installer, and dialog boxes will report the installation's progress to 
you. With any luck at all, your last message will be "Tempo Installed!"' 
When you Quit and return to the Finder, you must turn your Mac off and 
on again to implement Tempo. 
This should be a temporary step, not needed in the release version. 


B. Replacing the System 
1. In the Finder, drag a System which has Tempo already installed onto a disk without 
Tempo. 
2. If another System is already resident, select Yes to replace the existing System. 
Please Note: 

You may not replace a System currently in use. 

The Use "(disk name)" as default drive under the Configure... menu item must 
not be checked in the originating System before swapping. If Default is checked, Tempo 
will not be able to find itself on the destination disk. Simply uncheck the item before 
swapping systems. 

Also, Quit Tempo before copying the current System to another disk. 

Be certain there are no desk accessories or fonts which you want to save in the System 
which you are replacing. 

3. Reboot the Mac and you're ready to macro. 
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Tempo Functions 


A Tempo road map 
This is a complete listing of Tempo commands available in beta version 0.9K25. (The version 
number is found in the Save Macro? dialog box on selecting Stop Record or 
Rename....) 

Item Page 
Selecting Tempo 4 
Current Tempo Drive. 
The Tempo menu 
Start Record 
Tempo Command 
Play 
Edit* 
Rename 
Delete 
Import... 
Export... 
List 
Cancel 
Options... 
Configure... 
Command key modifier 
Option key modifier 
Default to "(current drive). 
Playback speed 
Quit 
The Tempo record menu 7 
Stop Record 
Save Macro? (Assigning a Key Code) 
Suspend Record 
Resume Record 
Options... 
Pause 
Pause for User Entry 
Include Dialog Box 
Resume with OK 
Auto Resume 
Pause for Interval* 
Pause Until* 
* Indicates not currently implemented 
Launch* 
Branch 
Loop 
Loop For... 
Loop If... 
Loop Until... 
Real Time 


* Indicates not currently implemented 


A. Installing Tempo in the menu bar 

1. Select Tempo from under the Apple menu. The first time, this brings up the dialog box 
Tempo Drive. 
2. Click OK or change disk or volume in Current Tempo Drive. 

You are choosing which disk or hard drive volume on which to 

store the file of Tempo macros that will belong to the current application. 

Generally speaking, select the disk or volume which contains 
the application currently in use. (The Finder is also an application.) 
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3. Click OK and you'll see the Tempo Command key symbol install 
itself on the menu bar. 
If you're using a hard drive with volumes, or a system disk and 
applications on disks without systems, click on Drive to change 
volumes (or drawers, or disks), and select the appropriate one. 


B. The Tempo menu 
1. Start Record 
Selecting Start Record changes the Command key symbol to a flashing R. This starts 
the recording process. Please see Recording a macro for more 
details. 
2. Tempo Command 
This selects the "heart" of Tempo, a dialog box which will allow you 
to view currently-available macros (those which can be used with 
the application currently running) and perform additional operations. 
When you select a macro, its full name and Key Code, if one has 
been assigned, appears at bottom of the Command window. You 
may read a macro name as wide as the Tempo Command window. 
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ee operations available from Tempo Command are as follows: 
a. Play 
This activates the selected macro. You may also double-click on 
the macro name. 
b. Edit (not currently implemented) 
This will allow a macro to be edited for errors or changes. 
c. Rename 
The selected macro may be given a new name or Key Code 
(see Recording a Macro for more on assigning names and Key 
Codes). 
d. Delete 
The selected macro will be deleted if you click Yes in the dialog 
box that follows. 
e. Import... 
This will allow you to select a macro that was created on 
another disk and add it to your current file of macros. 
f. Export... 
You may either move a macro to another file or create a file of 
macros, such as to send another computer via modem. To create 
a file of macros, simply select a disk which has no current 
Tempo macro file to export the macros to. You may shift-click 
or shift-drag to select macros that are located one above the 
other, or Command-Shift-click to select discontiguous macros to 
export or import. 
g. List... 
This will create a text file of macros and associated Key Codes. 
You may open the list using a text edit program such as 
MacWrite, Word, Jazz or MockWrite, and print the list for 
your reference. 
h. Cancel 
Cancels Tempo Command and returns you to the previous 
window. It will save any changes you have made to your 
macro files. 


3. Options... 


This is available only during Record mode. Please see Recording 
a macro for more details. 


4. Configure... 
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Selecting Configure... presents you with several choices: 
a. Command key macros 
This is the normal default. It means that if you choose to assign 
a Key Code to a Tempo macro, the Command key must 
accompany the code. You may either use the Command key 
plus one other character (letter, number or punctuation mark); 
or the Command key plus one or several other modifiers, 
including Option, Shift or Caps Lock keys, plus one other 
character. (Please refer to Save Macro under Recording.) 
b. Option key macros 
This is identical to the above, except you must have the Option 
key present in in every Key Code instead of the Command key. 
This will disable the Óption characters , so it's best used in 
applications where the option characters are not needed. 
You may toggle between Option and Command key codes 
within the same application, if you wish. 
Note: 
The Command-Option Key Code combination will work 
under either configuration. 
c. Default to "(current drive)." 
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Selecting this will bypass the initial Current Tempo Drive box 
(see Installing Tempo, above). 

It will save you a step each time you select Tempo from the 
Apple menu, since it will preset the disk or volume name. 
Unclicking this line will cause the Current Tempo Drive box 
to reappear. 

d. Playback speed 
This will allow you to play back a macro at any speed from 
full-tilt (100%) to agonizingly slow. Experiment to see what 
speed makes the most sense for certain conditions. 

The replay speed will remain set at the level you select until 
you change the level or Quit Tempo and reinstall it on the menu 
bar. 


S. Quit 
Removes Tempo from the menu bar. 


C. Special commands 
During replay of a macro, there are two keyboard commands almost aways available: 
1. Suspend replay: Command-, (comma) 
This replaces the flashing Command key symbol with an elipsis 
(...), and puts Tempo into an "idle" mode until you enter Command., again or 
select Resume macro from the Tempo menu. 


2. Cancel replay: Command-. (period) 
This cancels the replay of a macro as soon as the program it's running under allows the 


replay to stop. 
III. Recording a macro, the mechanics 


A. Start Record - menu changes 
When vou select Start Record, the disk will spin, the Command key symbol will change to a 
flashing R, and your keyboard or mouse commands will start to be recorded. | 
If you press on the flashing R, you'll notice that the Tempo menu has changed, as well. 
Your options are now as follows: 
1. Stop Record 
This will bring the Save Macro? dialog box. Your choices are: 
a. Cancel — returns you to record mode. 
b. No — is similar to "do not save." 
c. Yes — will save either the name assigned by Tempo (such as 
"Macro.a") or the name and Key Code which you assign. 
A Return in this dialog box will save the macro. 


Assigning a Key Code 
A Key Code allows you to replay a macro from the keyboard, without going to Tempo 
Command. You assign the Key Code after you finish recording a 
macro or when you rename a macro. 
You may do one of the following: 
D Hold down the Command key while pressing any character key. Examples are 
Command-1, Command-k, Command-[ , etc. The result shows up immediately in 
the Key Code box. 


or 

2) Hold down the Command key while pressing one or more modifier keys such as the 
Option key, the Skift key, and/or the Caps Lock key and any character key. 
Examples are Command-Option-a, Command-Shift-/, or 
Command-Option-Shift-CapsLock-t. 


Note: Command-Shift-Number keys are not allowed. 
These are called F-key resources, and are reserved for special uses. Some of these uses 
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include Command-Shift-1, to eject the internal disk, Command-Shift-3, to take a 
"snapshot" of the current screen, and so on. 

If you assign a Key Code which is already present in the menu, such as Command-X, 
Tempo will override the menu command. Should you not want this to happen, simply 
Rename... the macro with a new Key Code 

You may also choose the Option key as the primary modifier. This will disable the 
option characters in most programs, but is most useful where the Command codes are 
already extensively used, and in programs which do not use optional choaracters, such as 
Communications. 

In total, you have 450 Key Code combinations to choose from. 

2. Suspend Record 
This will stop all recording action. You may perform any actions 
and they will not be recorded for playback. You may suspend and 
resume at any point by selecting Suspend or Resume from the 
menu, or by entering a "Command-," at any time. 

The keyboard Suspend/Resume command may be entered 
during a modal dialog box operation, such as while opening a file or 
clicking "OK," if you don't wish that entry to be recorded for 
playback. 

3. Options... 
Behind Options lie some of Tempo's most powerful features, Pause, Launch, 
Branch, and Loop. 

These commands, which affect the replay of a macro, combine to form a virtual 
programming language on top of any Macintosh application, or even between Macintosh 
applications! 

For suggestions on how best to record complex macros, please refer to the following 
section, Recording a macro - the theory. 

The options available are: 

a. Pause 

Selecting this calls an intermediate dialog box selection, with the 

following choices: 

1.) Pause for User Entry 

This will cause a macro to pause on replay. The pause is 
indicated by a flashing "?" where the Command key symbol 
is normally found. The macro will resume when the user 
enters Command-Return or selects Resume from the 
menu. 
The choices at this point are: 
a.) Include Dialog Box (checked) 
This lets you enter instructions to the user in a dialog box 
which appears when the macro replays. You may choose 
one of the following at this point: 


i.) Resume with "OK" 
This requires an active mousedown on the OK button 
in the dialog box, before the user can enter the 
information and then resume with a Command-Return 
or Resume menu selection. 

ii.) Auto resume 
The dialog box will stay on-screen for about five 
seconds, then the macro will continue to play. 

b.) Include Dialog Box (unchecked) 
This will pause the macro on replay without a dialog box. 
A flashing "?" will indicate the macro is pausing for user 


entry. 
2.) Pause for Interval (not currently implemented) 
Waits the number of hours, minutes or seconds indicated 
before resuming the macro. 
3.) Pause Until (not currently implemented) 
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Waits until the time specified before resuming the macro. 
b. Launch (not currently implemented) 
Available only from the Finder. This allows you to select an 
application tc open. It avoids the problem of position- 
dependency which occurs when clicking on an icon to open a 
program. 
c. Branch 

Tempo's logic is first encountered here. Branch allows you to select another 
macro based on a comparison between the contents of the Clipboard and the number or 
text entered into the text box. You may compare up to 22 characters. 

A previous step recorded in the macro, or one that you know will have already 
taken place when the macro is implemented, should be a Cut or Copy to place data 
into the clipboard. Based on the conditional you specify, such as less than, equal to, 
etc., the macro on replay will either continue on to the next step, if the match is found 
to be false, or branch as directed, if the match is true. By recording a series of 
branches, you may check for several possibilities in a single macro ("...If it's greater 
than n, then do this; if it's less than n, do that; otherwise do the other"). 

1.) Boolean operators 

The standard less-than (<), greater-than (>), equal-to, etc., 
symbols may be clicked to changed the operator over the 
text window. 

Because some spreadsheets and databases use 
carriage returns or spaces as delineators between cells or 
fields, Tempo allows these codes to be entered following a 
number or text string. For this reason, Return cannot be 
used as the "OK" entry in the Options dialog box. 

2.) Always 

To unconditionally branch to another macro, select 
Record, immediately select Options..., and choose 
Always from the operators list. 

3.) Branch and return... 

Returns to the current macro after the operations of the 
branched macro have ended. 

4.) Branch and end... 

Stops after the branched macro has played. 
S.) End macro. 
Terminates the macro when the conditions have been met. 
d. Loop 
The logic of the Loop option works very similarly to the 
Branch option. 

It must always be the last option chosen while recording 
one macro. (Although that macro may be Branched to and 
returned from in another macro.) 

It affects all of the steps of the macro which it ends. 

It may be called by a Branch. 

1.) Loop For... 
Lets you specify the number of times to loop. 
2.) Loop If... 
Loops when the criterion is met. 
3.) Loop Until... 
Loops until the criterion is met. 
e. Real Time 
Selecting this option puts Tempo into a “journaling” mode. 
Every mouse movement will be played back at the same speed 
it was recorded. It also builds very large files, since the waiting 
periods and mouse movements are all recorded. 
There are certain times that Real Time will be needed 
beyond "guided-tour"-style demos. If a certain sequence within 
a macro does not seem to record properly, switch into Real Time 


Page8 ©1985 Affinity Microsystems, Ltd., Boulder, Colorado 





through the sequence, then switch to normal record for the rest. 


IV. Recording a Macro — The Technique 


Recording a macro is a little like programming anyway, and combining macros with 
conditional commands give Tempo macros far more power — and complexity — than any 
previous macros on a microprocessor. 
To quote from the Lotus 1-2-3 manual on the topic of macros, Allowing the computer to 
make decisions means there is a possibility it will make a decision you didn't anticipate. 
This is what programmers live with every day — finding unanticipated actions, called 
"bugs," and tracking them down to wipe theunm out. Your productivity with Tempo will 


benefit from following a few simple rules to help with your exterminations: 


1. Keep your macros modular. Three short recordings of command sequences will be far 
easier to change than one long, complex recording. 

2. Use Branching to move between applications. Fixing an error or changing a sequence 
to reflect new conditions is easier from within an application than if you must return to a 
previous one first. 

3. Use Real Time when an application calls events too quickly. It will give the 
application a chance to catch up with your commands. And you may easily switch into and 
out of Real Time as often as you need to, while recording a macro. 

Tempo can be very forgiving — scrolling up and down a menu won't be shown during 
replay, but try to be very precise - whenever possible try to perform a mouse-down correctly 
on the proper menu each time. 

Looping always refers to the entire macro, always goes at the end, and thus always brings 
up Save Macro box. 

To find the Tempo version number, select Start Record, then Stop Record. The 
version is at the bottom of the dialog box. 


There will be many additions to these Instructions in the manual to come. Please 
keep track of your particular frustrations so those who follow you will find 
using Tempo quick and easy. 


Bugs currently noted: 
Enter no more than 2-1/2 lines of text in a Pause for User Entry dialog box. More will 
cause the recording to cancel. 


This version does not work well in ThinkTank. 


If you crash during a Record or Replay and can't reinstall Tempo, you will get an error 
message suggesting you delete the file of macros. You must quit Tempo before you can 
delete the file, and you must empty the trash before selecting Tempo again. 


Miscellany: 
The file Tempo Scratch is for the programmers’ benefit, and will not appear in the released 
version. 


Back up your Macros file often. This is the Macintosh system file icon named Macros. 
You may simply click on the file, choose Duplicate from the File menu and a copy will be 
created. If you crash in Tempo and crunch your file of macros, you may trash it and delete 
the words Copy of from the backup file. (Be sure to then Duplicate that file before you 
rocede.) 

i You may hide your macros file in the System Folder if you wish. 

To include more than one Tempo file of macros on a disk or volume, simply change the 
name of the current file and another file called Macros may be used instead. 
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Select commands from the menu instead of giving keyboard commands whenever 
possible. It's less likely to get overlooked by an application on replay of a macro. 


In normal Record mode, Tempo records the exact location of where the mouse button was 
pressed, then the exact location of where it's released. If you click on File, then drag across 
to Edit instead, for example, Tempo will think you're still referring to the File menu when 
you select an item. Therefore, be very precise on where you click and release, whenever 
possible. 

In Real Time recording, all the mouse movements will be recorded. An example of the 
difference is in MacPaint, where a normal mode recording of a pencil tracing a circle will 
show a straight line between the "mousedown" and the "mouseup." In Real Time, though, 
the pencil will retrace all your motions. 


In Tempo Command you will only see those macros which can be played in the current 
application (including the Finder). To view all the macros in your current file, select Branch 
or Loop, which will present a listing of all macros in the current file. 


A very handy macro, right off the top, is Command-s for Save. This little command, 
used often, could just save a lot. 
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PowER USER SHORTCUT SUMMARY 


The Macintosh User Interface has been designed for ease of use by a wide range of users with many different levels of 
experience, In order to maintain your files most operations in the Finder are performed via menu items as well as 
selecting, clicking, and dragging with the mouse. For power users there are many built in shortcuts and additions 
which provide further user customization of how Macintosh deals with your files. The following keyboard and 
mouse shortcuts are for the following items collectively: System 3.0, Finder 5.1, Font/DA Mover 3.0. The 
various features are gathered below by topic. 


DOES IT HAVE NEW ROMS? 





New ROMs 

You can determine if the machine that you are working on has new 128KB Macintosh Plus type ROMs by the 
following two methods. First, when booting Macintosh a keen eye can distinguish between the older shadowed alert 
box that says "Welcome to Macintosh” and the newer symmetrical alert box. Secondly, if you select the "About the 
Finder..." option while in Finder 5.1, the memory size is displayed in the lower left corner. If the memory size is 
followed by a period, then that Macintosh has the new 128KB ROMs. If there is no period, it has the original 64KB 
ROMs. 


Upper Left Corner Of Disk Window [Finder] 
If you want to see if a particular disk is a HFS volume, open the disk's window in the Finder. Select an Icon view. 
If there is one pixel filled in at the upper left corner between the two lines near the top of this window then it is a 


HES disk, otherwise it is an MFS disk. 


BOOTIN MOUNTING 


Mounting Order [Macintosh Plus] 

The order of mounting volumes on a Macintosh Plus is: internal floppy drive, external floppy drive (regardless of 
whether it is plugged into an HD 20), HD 20 (if present), daisy chained HD 20 (if present), SCSI device 0, SCSI 
device 1, ... SCSI device 7. 


Mouse Down At Boot [Hard Disk 20 when booted from floppy only] 

As always, if you hold the mouse down when Macintosh is first starting up, the internal diskette is ejected. 
However, if you let Macintosh start normally and then hold the mouse button down when you see the "Welcome to 
Macintosh" box, the Startup disk will stay inserted in the drive and remain the current System and Finder that are in 
control rather than switch launching to the Hard Disk. This is often useful in troubleshooting the Hard Disk when 
the System or Finder on the Hard Disk is damaged or corrupted. If booting from the new 128KB ROMs, this feature 
is not present. Instead just boot from a floppy. 


Mouse Down At Boot [MacsBug 5.0] 

If you hold the mouse down during boot when you see the "Welcome to Macintosh” box and you are using the new 
MacsBug 5.0, the debugger will not be loaded, On a Macintosh Plus you still would have the built-in debugger to 
use in this situation. 


Command Option Mount [Finder] 

If these two keys are held down while a disk is being mounted (while booting up or right after a disk is inserted), the 
Finder will ask you if you want to rebuild its invisible Desktop file. Incidentally, this is also what the Finder does 
whenever it displays the dialog telling you that a disk needs minor repairs. This is often useful in troubleshooting. 
(The main side effect here is that your GetInfo comments are erased. In addition, on MFS volumes your folders are 
renamed to untitled 1,2,3...) 
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Command Option Tab Mount [Finder] 

If these three keys are held down while a disk is being mounted (while booting up or right after a disk is inserted), 
the Finder will ask you if you want to initialize the disk. If you cancel this operation then it will "fall into" the 
dialog for rebuilding the DeskTop file. This is a last ditch effort WHICH is sometimes needed for recovering a truly 
munged hard disk. 


LAUNCHING 


Option Launch Application [Finder] 

Holding down the option key while launching an application by double clicking on it transfers the active System and 
Finder to the disk that the application resides on (otherwise, if the System and Finder on a hard disk are active they 
will remain active). This is needed when using any of the various Installer programs, for example. 


Command Option Launch [Finder] 

This has the same effect as above, but in addition it allows you to run any file, regardless of what kind of a file it is . 
(Caution: this means you can run such files as the Clipboard File and the System which were never designed to be 
run in this fashion. The result in these cases can be disastrous!) As the Finder is normally not a launchable 
application, by using this command you may launch the Finder on another disk. This is also useful in development 
when you want to launch a newly created application whose type has not yet been set to APPL. 


WINDOWING 


Command Drag Window [ROM - Window Manager] i 

By holding down the command key you can select and drag a window on the Desktop or in an application without 
having the window become active. This allows you to move a window while keeping it behind the frontmost active 
window. 


Option Mount [Finder] 

If the option key is held down while a disk is being mounted, the Finder will not opeh any windows which (perhaps) 
would have been opened. This is useful if you want to quickly return to the Finder and you forgot to use Option 
Open when you originally opened up many windows in the search of a file. 


Option Open Window [Finder] 

If the option key is held down while a window is opened, the Finder will not ‘remember’ that the window has been 
opened. The net effect is that when you return to the Finder the next time after opening an application or document 
inside this window, the window will not open back up. 


Option Close & Option Click Go-Away Box [Finder] 

If the option key is held down while selecting the close option from the file menu, or if the go-away box is clicked 
on while holding the option key down, all of the windows on the desktop will be closed. (To earlier Finder users, 
this is the Close All command). 


ICON NFIGURATION MANAGEMENT 


Option Clean Up [Finder] 
By holding down the option key while selecting the Clean Up menu item (in the Special menu) all of the icons in 
the current window are automatically re-aligned from afresh to the grid. 


Command Drag Icon [Finder] 


By holding down the command key while dragging icons in a window, files are automatically aligned to the grid 
when released. 
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Option Drag to Trash [Finder] 

Normally when you drag an application into the Trash the Finder will prompt you with "Are you sure you want to 
remove the application...?" However, if you have a lot of applications that you want to trash quickly, holding the 
Option key down while selecting and dragging the files will suppress this dialog. Doing this will also allow you to 
trash files which are locked. 


QUITTING 


Option Quit [Minifinder] 
With the MiniFinder active and installed, holding down the option key while quitting an application will return you 
to the regular Finder rather than the MiniFinder. 


Command Quit [MacPaint] 
Holding down the command key when quitting MacPaint will reboot Macintosh. We're talking a cold boot folks. 
This is also true in QuickFile, another of Bill Atkinson's applications. | 


Enter [Minifinder] 
Pressing the enter key while in the MiniFinder is equivilent to selecting the Finder button with the mouse: It 
returns you to the Finder. (It may also be thought of as the MiniFinder quit button) 


Tab [Minifinder] 

Pressing the tab key while in the MiniFinder is equivilent to selecting the Drive button with the mouse: It toggles 
which disk is active. By doing this you may specify which disk's Finder you wish to Quit to, as the MiniFinder 
will launch any Finder on any disk as long as a Finder exists on that disk. 


RINTIN 


Command Shift 3 [System - FKEY] 

This will take a "screen shot” of the current screen and save it as a MacPaint file on your current System Disk. It is 
named Screen0. Additional screen shots are named Screen1 through Screen9. This is the only way to print screen 
shots on a LaserWriter, namely, by saving a screen shot, entering MacPaint, and printing to the LaserWriter in 
MacPaint. (Print draft is unsmoothed, Print final uses smoothing) 


Command Shift 4 [System - FKEY] 
This will print the active window to the ImageWriter (the LaserWriter is not supported). If you are also pressing the 
mouse button, the action will start when you release the mouse button. 


Command Shift 4 w/Caps Lock down [System - FKEY] 
This will print the entire screen to the ImageWriter (the LaserWriter is not supported). If you are also pressing the 
mouse button, the action will start when you release the mouse button. 


Command F When Printing To LaserWriter [Laser Writer] 

If you wish to create a Postscript file on your disk rather than printing it to the LaserWriter, select print from your 
application and when you get the standard LaserWriter box, immediately after saying okay press Command F, which 
creates a file named "Postscript" which is a TEXT file containing the actual ASCU code that would have been sent to 
LaserWriter. You can then modify the code and resend it by using PSDump, a Laser Writer utility. 


MISCELLANEOUS BIZARITIES 


Option Launch [FDA Mover] l 
By holding down the option key while entering the Font/DA Mover you will select the Desk Accessory mode rather 
than the default Fonts mode. 
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Option Open [FDA Mover] | 
By holding down the option key while clicking on open in the FDA Mover, all of the files on the disk are displayed 


(not just font or DA files), allowing you to move fonts and desk accessories in and out of any files which have 
resource forks. 


Option Close [FDA Mover] 


By holding down the option key while closing a list of Fonts or DAs, the disk upon which that file is located will 
be ejected. 


Option Quit [FDA Mover] | 
By holding down the option key while selecting the Quit button all non-essential disks will be ejected, i.e., all disks 
other than the current system disk. 


Tab in Std File [System - PACK 3] 
Pressing the Tab key in Standard File dialogs (the Save & Open dialogs) is equivalent to pressing the Drive button. 


Typing In Std File GetFile [System - PACK 3] 

If you type a single letter when you are viewing a list of documents in an open dialog, the first file which begins 
with that letter (or the next file that follows) will be selected. If you quickly type more of the filename then a file 
with that specific filename will be chosen. (It actually works better than my description of it) 


Cursor Keys In Std File [System - PACK 3] 

The cursor keys on the new Macintosh Plus keyboard allow you to move up and down through the hierarchy when 
in a Std File dialog box. The up and down arrow keys allow you to scroll to a file of your choice. If you scroll to a 
folder, use CMD and the up arrow to move you closer towards the root directory. Use of CMD down on a folder 
allows you to descend deeper into the disk, that is, to open that folder. 


Option Name Newly Formatted Disk [System - PACK 2] 

If you wish to make a 400K HFS volume, do the following: Initialize a disk and name the disk in the proper disk 
init dialog. By holding down the option key when terminating the naming dialog (via Return or Enter or clicking 
on the okay box) a 400K disk is made a HFS volume rather than an MFS volume. Note: you must have had the 
chance to name the disk via the proper dialog box or else the disk will not be formatted as HFS. 


Command Shift 1 & 2 [System - FKEY] 

These keys will eject the internal floppy and external floppy disk drives, respectively. If a Hard Disk is attached to 
the External Drive Connector with a floppy daisy-chained to it, the floppy will be ejected. At no time will a Hard 
Disk be ejected via these keys (although you can throw the hard disk into the trash). 
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MacTablet Interface 


Have you ever wondered what a tablet is and how you would use it in your application? If so, 
we've got the answer for you. While the mouse is a great pointing device, it has its limitations in 
applications that require drawing and tracing like CAD, drafting, mapping, and animation. With a 
MacTablet graphics tablet you have all the capabilities of a mouse in addition to several other 
features. À 


MacTablet vs. Mouse 


The MacTablet and the mouse are like fraternal twins -- similar, but different. Their differences 
are in ease of use, resolution, and positioning technology. 


The stylus makes the MacTablet a better tool for creating fine detail drawings and tracing existing 
drawings, maps, photos, etc. To illustrate this, try writing your name with a mouse then try 
writing it with a stylus. With the Mouse you write with your hand. With MacTablet you write 
with your fingers like a pen. With the stylus you have much more control. 


The high resolution capabilitiy of the MacTablet (over 500 lines per inch) allows you to input much 
more highly accurate data for critical applications like maps and tracings. And because you have 
input defined in high resolution you can get the most out of high resolution output devices. 


MacTablet is an absolute-position device. Touch the tablet anywhere with the stylus, the screen 
cursor jumps to the corresponding position on the screen. But you've got to drag the mouse to 
where you want it. The mouse doesn't know about specific screen locations. Another way of 
expressing this is that the MacTablet driver returns an X and Y value, while the mouse returns 
direction and magnitude which must be converted to X and Y. 


With MacTablet you can also reduce and enlarge graphic images to fit your Macintosh screen. The 
MacTablet driver provides the programmer with the means of defining an area on the tablet that 
maps to the Macintosh screen while maintaining the proper aspect ratio (relationship of width to 
height). The area of the tablet that is mapped to the screen is called the viewport. When you move 
the stylus inside the viewport, the cursor tracks with it. When you move the stylus outside the 
viewport, the cursor no longer tracks with the stylus, but freezes at the screen edge. 


The MacTablet driver lets you define where the viewport is located on the MacTablet. And you 
have a choice of scales. The scale is the ratio of the tablet to the screen. One use of scaling would 
be to let you reduce or enlarge images on the tablet to fit the screen. Use a larger scale e.g. 1.6:1, 
to reduce the image on the tablet. Use a smaller scale e.g. 0.5:1 to enlarge the image on the tablet. 
Regardless of the scale, the viewport always retains the correct screen aspect ratio so circles will 
always be circles. 


Since MacTablet is larger than the Macintosh screen, all of the active area of MacTablet is not 
available to the screen, but it is available to the developer for many different uses. An example 
would be to place a preprinted menu on MacTablet that doesn't appear on the Macintosh screen. 
This would allow total use of the screen without limiting the capibilities of an application. 
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Applications written for the Macintosh following the guidelines set forth in Inside Macintosh can 
be used without modification with the MacTablet driver; however, the functionality of an 
application can be expanded if it is written to take advantage of the features that the MacTablet has 
to offer. The interface to the MacTablet driver will consist of standard device driver Control and 
Status calls. The following functions will be supported by these calls: 


* Starting and stopping the MacTablet driver. | 

* Returning the current size tablet, the current scale, and the location of the viewport. 

* Returning the absolute X and Y values of the stylus position before being scaled for the screen. 
* Returing the code for the button currently being pressed(MacTablet supports up to four buttons). 
* Setting the scale and the location of the viewport. 


MacTablet is a professional graphics tablet like the ones Summagraphics has been designing for 
expensive CAD systems for the last 14 years. It uses electromagnetic technology which makes it 
very accurate and reliable. To accomodate a variety of original material sizes, MacTablet is 
available in three sizes -- 6'x9",12"x12" and 12"x18". For applications requiring precision 
tracing, an optional four button puck with crosshair sights is available. Because Summagraphics is 
the leader in the tablet industry, most other tablet manuafacturers support the MM data format, the 
format used by MacTablet. 


Summagraphics is looking for developers who wish to create applications using graphics tablets. 
We'll help you with the interface solution. We provide code examples for interfacing MacTablet to 
your Macintosh application, full documentation, support, tablets and the knowledge we've built up 
over 14 years of manufacturing digitizers and developing user interfaces. For more information 
contact: | 


Developers Group 
Summagraphics Corporation 
777 State Street Extension 
Fairfield, CT 06430 

(203) 384-1344 
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Technical Development 


Macintosh and the 800K External Drive 





The following configurations are recommended for use of the new 800K External Drive 
with the various Macintosh systems: 


128K Macintosh—This configuration is not recommended; many applications will not 
run because of the significant amount of memory taken up by the RAM-based disk driver 
and file system. If you want to try anyway, place the following files in the System 
Folder of your startup disk: 


« System 2.0 (creation date 5/4/85) 
* Finder 4.1 
* Hard Disk 20 1.0 (from Hard Disk 20 Startup) 


You must start up from a 400K Macintosh File System (MFS) disk in the internal drive; it 
is not possible to start up from the external drive. (Caution: This configuration does not 
allow you to use the Hierarchical File System, (HF S). Disks in the external drive will be 
formatted as 800K MFS volumes.) 


Macintosh 512K, unmodified—With a Macintosh 512K, you can use 800K HFS 
disks in the external drive by putting the following files in the System Folder of your 
startup disk: 


* System 3.0 or later 
* Finder 5.0 or later 
« Hard Disk 20 1.0 or later 


You must start up from a 400K MFS disk in the internal drive; it is not possible to start 
up from the external drive. 


Macintosh XL—The 800K External Drive does not function with the XL, however, 
the following new system software works fine: 


« Finder 5.1 or later 
e System 3.1 or later 


Macintosh 512K with 800K Internal Disk Drive or Macintosh Plus—With a 
Macintosh Plus, a Macintosh 512K upgraded to a Macintosh Plus, or an enhanced 
Macintosh 512K (with the 800K internal disk drive), you don’t need to have the Hard 
Disk 20 file on your startup disks (if you have it, it will just be ignored). You can start 
up from 800K HFS volumes in either the internal or external drive, using the following 
software. 


* Finder 5.0 rr? cc 
e System 3.0 or later 
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The software can be taken from the following disks: 


* Hard Disk 20 Startup (Hard Disk 20, Finder 5.0, System 2.1) 
° CET Plus System Tools (Finder 5.1, System 3.0, Image Writer 2.1, LaserWriter 
| Printer Installation (Finder 5.2, System 3.1, Image Writer 2.2, LaserWriter 3.0) 


Note that with System 3.0 or later, you use the Chooser desk accessory (rather than the 
Choose Printer), and that only Image Writer 2.1 or later and LaserWriter 1.1 or later are 
compatible with Chooser. 





Programming Aids 


The Extender is a powerful programming tool, which novices as well as advanced 
programmers will find a tremendous timesaver in program development. Pascal Extender 
and C Extender are run-time libraries that contain routines designed to simplify and 
enhance Macintosh interface programming. After installing the libraries on the language 
disk, the Extender routines are called as easily as any other library routines. 


Features include: 


* Windows— A single function call will create a window, set up vertical and horizontal 
scroll bars, a “go-away box," and a “growbox” as desired. The following operations 
for handling windows are supported automatically without requiring any input from the 
programmer (although advanced programmers may make modifications easily). 


—Window resizing with automatic updating of text or graphics and scroll bar 
repositioning. 

—Updating of all windows (no limit on the number of windows displayed except 
memory). 

— Window selection and "dragging." 

—- Showing and hiding windows. 

— Automatic cursor adjustments (for example, from arrow to I-beam). 

— Automatic scrolling of graphics ot text. 


Menus—A single procedure call will both create and display a customized pull-down 
menu. Special features, such as keyboard equivalents, highlighting, disabling 
(graying of selected items), checkmarks, and displaying items in other fonts, can be 
included in the procedure as desired. Menu items can be changed in midprogram and 
can be created in the program or read directly from resource files. Menu selections are 
read automatically. 


Controls—Single procedure calls create push buttons, check boxes, and "radio 
buttons" with custom titles, full mouse tracking, and automatic highlighung and 
disabling. All control-related events are reported directly to the user; no polling of 
controls 1s required. 
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* Scroll Bars—A single procedure call creates a horizontal or vertical scroll bar of any 
size and controls its placement. Scrolling and paging increments are controlled 
automatically. 


« Graphics Printing—A single command will print the contents of any window or 
up to one full page (8.5 x 11 inches) on the ImageWriter or LaserWriter 
printer. 


* Desk Accessories—Desk Accessories are fully supported automatically. 


+ Text Editing—All text-editing features (TextEdit) are fully supported, including 
selecting, cutting, copying, and pasting text, as well as changing size and font. In 
addition, cutting and pasting to and from the System Clipboard is also fully supported. 
Automatically controlled features include: 

—Full support of multiple text records on multiple windows. 
— Horizontal and vertical text scrolling. 
— Word wrap. 


« Dialog and Alert Boxes—Dialog and alert boxes in resource files can be easily 
called up and modified as desired. Text entered in dialog boxes is easily read by your 
program. 


The Extender code uses standard Apple Toolbox data structures; therefore, all direct 
"Inline" Toolbox calls remain supported and will function as expected. Many user 


. “hooks” are provided so that the advanced programmer can choose to take control of any 


or all events, including: 

« Window handling. 

* Keyboard events. 

* Menu handling. 

* Graphics and text scrolling. 

Particular windows can be declared as “exceptions” to be handled by your own routines 

while allowing other windows to be handled automatically by the Extender. Thus, the 
rogrammer can freely intermix high-level handling of routine events with special low- 
evel calls as desired. In addition, the Extender provides a large number of optional 


medium-level procedures that can be used by the advanced programmer to modify the 
standard Extender procedures and functions. 


Extender versions for compilers use about 10K. Pascal Extender for the Apple Pascal 
interpreter uses about 29K. 


A book-length manual (200 pages) is provided with tutorial, reference. index, and 
numerous sample programs. 


There are no extra royalty fees if you market programs created with the Extender. 
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PASCAL EXTENDER for: 


> Apple Macintosh Pascal Interpreter $69.95 
TML MacLanguage Series Pascal $69.95 
C EXTENDER for: 
Aztec C $129.95 
Megamax C $129.95 
PASCAL and C EXTENDER COMBINATION 
PACKAGE (2 disks and 2 manuals) $179.95 


PASCAL INTERPRETER + TML COMPILER 
EXTENDER COMBINATION PACKAGE 
(2 disks and 1 manual) $119.95 


For information or to purchase, contact: 


INVENTION SOFTWARE CORPORATION 
P.O. Box 3168 

Ann Arbor, MI 48106 

(313) 996-8108 & 
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Macintosh Plus Specifications 
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Processor: 
MC68000, 32-bit internal architecture, 7.8336-megahertz clock frequency 
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Memory: 
1 megabyte RAM 
128K ROM : 
Includes 256 bytes of user-settable-parameter memory i 


Disk Capacity: 
800K per formatted double-sided disk 
3 1/2-inch, hard-shell media 


Screen: 
9-inch yi ee monochrome display 
512 by 342 pixels, bit map 


Interfaces: 
Synchronous serial keyboard bus 
Two RS-232/RS-422 serial ports (230.4 kilobaud maximum) 
Mouse interface 
External disk-drive interface 
SCSI interface (320K bytes per second maximum) 


Sound Generator: 
4-voice sound with 8-bit digital-analog conversion using 22-kilohertz sample rate 


Input 
Line voitage: 105 to 125 volts AC, RMS 
Frequency: 50 or 60 hertz 
Power: 60 watts 


Keyboard: 
78 key, 2-key rollover, software mapped, detachable, with built-in numeric keypad 
and direction keys 


Mouse: 
Mechanical tracking, optical shaft encoding 3.54 pulse per mm (90 pulse per inch) 
of travel 
Clock/Calendar: 
CMOS custom chip with 4.5 volt (Eveready No. 523 or equivalent) user-replaceable 
battery backup 
Dimensions Weight Height Width Depth 
Main Unit 7.5 kg 344 mm 246 mm 276mm 
16 1b.8 oz. 13.5 in. 9.7 1n. 10.9 in. 
Keyboard 1.2 kg 65 mm 395.4mm 146mm 
2 1b.10 oz. 2.6 in. 15.6 in. 5.8 in. 
Mouse 2 kg 37 mm 60 mm 109 mm 
7 oz. 1.5 in. 2.4 in. 4.3 in. 
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Environment 
Operating Temperature: 50° to 104? F (10° to 40° C) 
Storing Temperature: -40° to 122° F (-40° to 50° C) 
Humidity, all conditions: 5% to 90% 
Altitude: 0 to 15,000 feet (0 to 4615 m) € 





LaserWriter Plus Specifications 





Marking Engine: 
Canon LBP-CX laser-xerographic engine 


Processor: 
Motorola 68000, 12-megahertz clock speed 


Memory: 
1 megabyte ROM 
1 1/2 megabytes RAM 


Interface: 
AppleTalk and RS-232C 


Print Quality: 
All text and graphics printed at 300 by 300 dots per square inch 


Built-in Fonts: 
Helvetica, Times, Courier, Symbol, 
Palatino, ITC Avant Garde Gothic, ITC Bookman, 
Helvetica Narrow, New Century Schoolbook, 
ITC Zapf Chancery, ITC Zapf Dingbats 


Speed: 
8 pages per minute maximum throughput 


Printing Protocols: 
PostScript, and a subset of the Diablo 630 command set 


Print Materials: 
Letter, Legal, A4, B5 sizes 
16- to 20-Ib. single-sheet photocopy bond 
8- to 34-Ib. letterhead and colored stock 
Transparency overhead film 


T 


Enveiopes and labels supported via manual feed 


Printable Surface 
Letter size: 8 by 10.9 inches 
Legal size: 6.75 by 13 inches 
A4: 7.41 by 10.86 inches 
B5: 7.69 by 10.16 inches 


Kahl MER io) SCHNICAL DEVELOPMENT SPRING 1986 75 





Dimensions Weight Height Width Depth 
77 lbs. 11.5 in. 18.5 in. 16.2 in. 
(Depth is 28.2 inches with trays attached) 


Power: 
U.S. Model: 115 VAC (+ 10 percent) 60 hertz % 


Macintosh 800K External Drive Specifications 





Disk Capacity: 
800K per formatted double-sided disk 
1246K per unformatted double-sided disk 
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Recording Media: 
3 1/2-inch hard-shell media 
2 recording surfaces 
80 tracks per inch 


Interface: 
Connects directly to the Macintosh or 
Macintosh Plus disk-drive port 


Characteristics 
Seek Time: 6 milliseconds maximum (track to track) 
Settle Time: 30 milliseconds maximum 
Drive Startup Time: 600 milliseconds maximum 


Power Requirements: 
+12 volts 
Standby: 10 microamps 
Typical: 120 milliamps 
Peak: 600 milliamps (during eject, 2-second maximum duration) +5 volts 
Standby: 10 milliamps 


Typical: 200 milliamps 
Head Position: 
+/-0.035 millimeters 
Dimensions 
Weight Height Width Depth 
Cod NE 18.5 min 120 mm 200 mm 
ot ths. Loe ETIAM: r 8 u 
Environment 
Operating 


Ambient Temperature: 40° to 122° F (5° to 50° C) 
Relative Humidity: 5% to 90% 

Nonoperating 

Ambient Temperature: -40° to 140° F (-40? to 60° €^ 
Relative Humidin SH ra ONS 
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This article explains some of the things that have been enhanced in the new ROM. First 
of all, the hierarchical filing system that Apple has been shipping as RAM-based with the 
Hard Disk 20 is now in ROM. Also, the ROM has been modified so that it is now 
capable of starting up directly from a hard disk (no 3 1/2-inch disk required). 


The new ROM is designed to enhance performance as much as possible without 
sacrificing compatibility with existing applications. Here are some of the new features 
and performance enhancements: 


QuickDraw, which was already very fast, has gotten even faster, for example, the speed 
of special cases of CopyBits has tripled. Other performance enhancements include 
FillRect, PaintOval, and PaintRRect. By popular demand, QuickDraw now includes the 
routines that form the basis of the MacPaint program lasso and paint bucket tools. These 
calls, named CalcMask and SeedFill, will help you add these features to your programs. 
The Resource Manager has been made faster. It now uses a smarter algorithm tor 
compacting a resource file, one of the slowest parts of the old Resource Manager. It also 
uses various caching techniques to make itself faster. In addition, the Resource Manager 
has implemented a set of calls that search for a resource only in the current resouree map. 
These calls, called *one-deep" calls, will speed up your performance if you only want to 
search the current map. 


The Window Manager and the standard window definition function (WDEF 0) now 
implement window zooming. This new feature allows you to expand a window to full 
size by clicking in a special “room box” that appears at the top right corner of the window 
frame. Clicking in the zoom box of a window that’s already full-size causes 1t to shrink 
to its previous size. 


The standard menu definition procedure (MDEF 0) has been enhanced, too. It now 
allows menus that are too long to fit on the screen to scroll when the user drags below the 


last visible item. This feature is great for folks who like to have lots of fonts, because all 
the fonts will now be accessible from the font menu. 


With the doubling in size, the new ROM is able to accommodate lots of things that had to 
be loaded into RAM on the old system. For example, both of the floating-point math 
packages (PACK 4 and PACK 5) are now in ROM, as is the binary-decimal conversion 
package (PACK 7). Most of the standard definition procedures are also in ROM— 
CDEF 0 and 1, MDEF 0, and WDEF D -along with the AppleTalk drivers .MPP and 
ATP. 


(The material above was written by Scott Knaster of Apple for the January 1986 issue of 
Outside Apple.) 
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LaserWriter Fonts vs. Screen Fonts 





The LaserWriter can print its built-in fonts both beautifully and quickly because of the 
way these fonts are designed. To understand why, you must remember that the 
LaserWriter has a resolution of 300 dots per inch, compared to the 75 dots per inch on the 
Macintosh screen. The fonts you see on your Macintosh screen, called screen fonts, are 
designed for the screen’s 75-dot-per-inch resolution. So when you print one of these 
screen fonts, such as London, on the LaserWniter, you can actually see the dots it’s 
designed with. Even with smoothing (a LaserWriter instruction that smoothes curves by 
adding dots), the printed screen fonts don’t look as sharp as LaserWriter printer fonts. 


That’s because, unlike screen fonts, which are designed and stored for each point size, 
printer fonts are designed and stored as outlines. PostScript processes these outlines, and 
creates bitmaps—on the fly—at 300 dots per inch. These are perfect 300-dot-per-inch 
characters, regardless of the point size. 


In fact, in addition to being point-size and orientation independent, the process is also 
device independent. You can print from your Macintosh computer onto ail other 
AppleTalk/PostScript printers. For example, you can print on the Linotronic 300/P, a 
laser typesetter, at 2,450 dots per inch. 


As for the speed issue, the LaserWriter prints its built-in fonts more quickly because it 
has the stored outline of the fonts. When printing a screen font, the printer has to spend 
time generating a 300-dot-per-inch bitmap from a 75-dot-per-inch bitmap, which involves 
a lot of time-consuming conversions. 


(Adapted from an interview with Elizabeth Yerxa, LaserWriter printer product manager. 
Interviewed by Joanne Koltnow for the January 1986 issue of Outside Apple.) & 


WHEELS FOR THE MIND - TECHNICAL DEVELOPMENT SPRING 1934 











This section of Wheels for the Mind contains hints, tips, and techniques gathered from software 
authors, vendors, users, publications, user groups, and just about anywhere else. The section is 
cumulative; each issue, new tips will appear preceded by an Apple logo 6. If you have tips to 
share, please send them along to the editor: Peter Olivieri, Computer Sciences, Boston College, 
Fulton 430, Chestnut Hill, MA 02167. 


MACPAINT 


Many thanks to MacPaint author Bill Atkinson, who provided these great MacPaint tips. 





CONSTRAINING IS A GREAT TOOL. When you use the key in conjunction with some 
of the tools in MacPaint, tne results can be quite impressive. 


Ent] - Using this while in FatBits will help you fill in straight lines, both vertically and 
horizontally. I'll bet everyone has tried it freehand at one time or another with little success. 


Shift] -Z This allows you to erase areas without “wandering” into other areas of your drawing 
that you want to leave untouched. 


- dj This gives some great effects. Try using the “fence” brush shape with key and 
you'll get some nice borders. 


- m This can be used to move the screen up and down (or left and right) without straying 
from your intended course. This also works quite nicely in Show Page mode. 


- UI This makes perfect squares. 


- C3 This makes perfect circles. 


FAST FATBITS. If you have ¿Y selected, hold down the key and click your Ü cursor at 
the spot where you want FatBits to be displayed. This is an amazingly fast way to get in and out of 
FatBits. It is much better than double-clicking or using the menu to do this. 


MULTICOPY. Holding down the and keys while dragging creates some interesting 
features. They are best explained with a demonstration, so please sit down at a Macintosh and try 
these. 
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DOTTED LINES AND CIRCLES. Select a line width that is fairly large. Select a brush shape that 
is a dot (not too big a dot). Use the b tool to place a dot on the screen. $— the dot. Use the 
multicopy technique to draw a dotted line. Try making a dotted circle. 


with the multicopy technique does some neat constraining. Try this: Draw a rectangle with 
a decent-size border. Suppose the rectangle is not quite long enough. Use the 771 icon to select 


ho ul 


the right half of it; use with multicopy to stretch the rectangle to the right. Better yet, try 


this: Fill in the rectangle with a “noisy” pattern of your choice. If you now try the 
multicopy technique (preceding), the pattern will not "stretch" correctly. Do not despair. Go to the 


Goodies menu and select Grid. Now try the multicopy method, and the pattern will copy as 
well. Try this; you'll like it! Bill Atkinson calls this technique the “three-finger stretch.” 


UNDO is much easier if you use the upper left key on the keyboard. That's right, it works just like 
the menu item for Undo but lets you react faster. 


TRANSPARENT PAINT is a neat effect. Try the following. Paint several stripes on the screen. 
Paint another color across them. Notice that the last stripe painted is opaque. Now hold down the 


| [88 ] while Sainting another stripe... you cot u: ent paint. If you select the filled-in [_] 
| tool, you can even draw a background "behind" what is on the screen. This technique also allows 
you to paint near curved or straight lines without spilling over onto the line itself. (You've all done 


that!) Try these... you'll be impressed. 


PATTERN GRABBING. Let's suppose that a friend gives you a disk that has some neat patterns 
on it that you'd like to have. You really don't want to go to the trouble of editing a pattern in detail. 
Try this: Paint the pattern of interest onto the screen somewhere. Double-click on a pattern in the 
pattern palette that you won't mind replacing. When the "pattern edit" box appears, move to your 
document and just click somewhere on the pattern you like. That's it. It's yours. 


TYPING TEXT. Sometimes when you're in text mode you would like to change styles (perhaps 
do something in bold). However, when you click the mouse to change styles and then click again 
tO start typing, you often can't easily line up the typing so it looks continuous. If you press 
instead of clicking, all your typing will be on a straight line. 


SAVING MACPAINT SPACE. If you have a lot of MacPaint pictures, you may be using a lot of 
space on your disk. If some of your "drawings" are not a full page, you can get some of your 
space back. The technique is to “combine” some of your pictures. If you get two pictures on a 
single document, you will save about 2K per document. It adds up! 


MACPAINT 1.4 BUG. When using MacPaint Version 1.4 on a Macintosh 512K, you can crash 
the application with a system error if vou use Show Page after opening ar old document. You can 
get around this problem by openinz MacPaint from the desktop ard then using the “Open” 
COTA io get at die document of inierest. 


QUICK EXIT. Lots of current users are leaving MacPaint the fast way: Hold down the kev 
whie choosing Quit from the file menu. The disk ejects, the tone sounds, and the Macintosh 
reboots. However, you really shouldn't use this method, as it doesn't guarantee that your disk 
directory will be in perfect order. 
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Double-Click] on the Y icon and the full page is displayed. 


MOVING OBJECTS . If you use the § icon to move and copy objects, the “white background” 


"i 


that follows when you use the 1. icon stays behind. This is especially useful when overlaying 


E 


one picture onto another. In effect, the $? captures only the object that is selected. 


PLACING OBJECTS ON TOP OF OTHER OBJECTS. If you wish to make an item transparent 
(say the lenses in a pair of eyeglasses), leave a little break in the frames where the lenses are. 
Using the £^ icon will allow you to capture only the "borders" of the frames and allow the final 


d- to look like real eyeglasses (that 1s, you can “see” through them ). Try this to get the full 
effect. If you wish, you can then use FatBits to “repair” the breaks in the frame. 


MAKING AN EXACT COPY OF AN OBJECT. After you select an object with the 6? icon or 
the 1^1 icon, you can make an exact copy by holding down the 9 key, pointing to your object 


=é 


(make sure an arrow appears), pressing down the mouse button, and then dragging to a new 
location. Letting up on the button places your copy on the page. You can continue making as 


many copies as you wish. 


MAKING MULTIPLE COPIES OF AN OBJ ECT. Youcan make repeating copies (a nice effect) 
by selecting an object with the @ icon or the {_3 icon, holding down both the [óptica] key and 
the key, pointing at the object until an arrow appears, and then dragging the mouse while 
holding the button down. Interesting note: The current line width determines how much space will 
be between repeating copies as you do the dragging. Try some different line widths to get a feel 
for this. 


STRETCHING AN OBJECT. Select the object, using the 171 icon. Hold down the key 
and point to one of the edges of the enclosed figure. When an arrow appears, hold down the 
mouse button, drag the enclosed area left or right (maybe up or down), and watch your object 
stretch! 


ENLARGING AN OBJECT. When you paste an object onto the screen, it returns in the same size 
that it was cut (or copied). You can cause it to return as a larger or smaller image than the original. 


Before you paste, use the [_: icon to place a border rectangle on the screen. Make the size of this 
rectangle equal to the size you would like your object to be. When you now use the Paste option, 
your object gets resized accordingly. 


CHANGING FONTS AND TEXT SIZE. Sometimes it's awkward to use the mouse and menu 
system for changing font styles or type sizes. If you hold down the ®_] key and the key, 


| nnd then press >. vou will automaricaliv call the next font. Each ‘ime you press > vou will call 


another font. To try different text sizes. just hold down the [36 | xev while you press >. Atter 
trying this for a bit, you may prefer to use this technique all the time. 


AUTOMATIC MACPAINT DOCUMENT. If you hold down the £ ] key and the key 
and then press 3, the current screen will be saved as a MacPaint document called SCREENO. (You 
can save 10 such “paintings.”) That drawing is now available to you in \facPaint. This allows for 


some verv creative applications. 





NO BORDERS. If you select the dotted line from the border palette, your filled rectangles and 
Circles will have no outline. 


HIDDEN FEATURE. Select a drawing with the = icon and hold down the key. Select 
Trace Edges from the Edit menu and your drawing will now have a shadow. 


CUSTOM PATTERNS. If you create a MacPaint document that contains several boxes with 
various patterns that you designed, you can easily call them up while drawing and transfer them to 
your pattern menu at the bottom of the page. Just use Cut and Paste to transfer a pattern from your 
MacPaint pattern collection to the pattern you wish to edit. 


TRANSPARENT PAINT. You can paint with transparent paint. Hold down the key and 
use the $ , A ‚or. 


CATALOGS. In the Goodies menu, there is a Print Catalog selection. Using this command, you 
can get a one-inch-square "picture" of all of the MacPaint pictures on your disk. It makes a handy 
reference. 


€ SAVE SPACE. MacPaint Ines ==: necd the Guage ss resource in your System Folder. 
You can trash it and get a little more space on your disk. 


€ SAVE MORE SPACE. If you have a copy of the Resource Editor, you can examine the 
MacPaint disk and remove the "pictures" that display "Short Cuts" and the "Introduction." This 
will save about 13K. 


€ ERASING. Another way to erase things in MacPaint is to choose white paint, choose the 
filled-in rectangle, and draw a box with no border (dotted line from line type choices). You can 
then "erase" by drawing a white box over the unwanted material (assuming your background is 
white). 


€ SHADOWS. Select a part of your drawing by using the 5 , and then hold down the 
key and choose Trace Edges from the EDIT menu. 


MACTERMINAL 


The following keystroke combinations may be of interest to users of MacTerminal: 
H — Backspaces cursor one space 
3b I Moves cursor to right to next Tas 

J| Moves cursor dowii obe line 

K Moves cursor down two lines 

M . Moves cursor back to start of line 

G Causes tone to sound 
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MACWRITE;| 


CHARACTER ACCENTS. To use an accent, umlaut, and other characters in conjunction with 
letters, do the following: First press the key combination that produces the special character (look 
at Key Caps to see what combination is required), then type the letter you want in that same 
position. The ^ and the^ work only with the lower-case vowels. The ' also works with E. The ~ 
can be used with a, o, n, and N. The " works with lower-case vowels and upper-case A, O, and 


IMAGEWRITER SWITCHES can control your printer in a variety of ways. There are two sets of 
switches on the ImageWriter. The first set, called SWI, controls some of the features of draft- 

mode printing. SW2, the second set, has switches that can cause irregularities in your printing if 

they are not properly set. If you want to use a foreign language set for draft printing, you can 

change the switches marked 1, 2, and 3. The settings for different character sets can be found in 

pe mm user's manual (page 44). The pitch can also be modified with switches 6 and 7 
see page 41). 


SW? has three switches that will affect printing in any resolution if not correctly set. Switches 1 
cad 2 control the baud rate. MacWrite and Multiplan both need 7600 oaud (both swiss 
closed—see page 39). Switch 3 controls the XOn/XOff protocol. If the setting is not correct, you 
will get a dialog box that says "Printer Is Not Responding." 


1 —— in - 


| DOUBLE LINES can be created in MacWrite by choosing Underline from the Style menu and then 

ing with the underscore character (SHIFT - ). To get the “double line” under words, you must 
| enter a double line for a few spaces, then begin typing your words, and then end with your double 
lines again. This feature does not work on the LaserWriter printer yet. 


MACWRITE DOCUMENT SIZE. A MacWrite document on a Macintosh 128K is limited to about 

| 27.000 characters. This is nearly 5,000 words, or 20 double-spaced pages, in 12-point type. If 
you use a lot of fancy fonts and graphics in your paper, you won't be able to have as many pages. 
With a Macintosh 512K, you can have about 80 double-spaced pages (roughly 20,000 words). 


QUICK ERASING. To erase some text, select it in the usual way and press the key. 
it’s gone! You may prefer to use Cut or Copy if the text will be used again. Another alternative is 
E to select the text and begin typing the new material. The new material will automatically replace all 
of what you selected. 


SAVE SOME MACWRITE SPACE. On your MacWrite disk, put the Sample Memo in the Trash 

(saves 3K). Even more space can be saved if you remove fonts that you really never expect to use. 

This can easily be done by using the Font Mover application. Be careful not to remove any of the 

System Fonts. | 
| 
344 ¿ MORE MACWRITE SPACE. If you save your documents without spec sui 10085, rulers, | 
and pictures, you can save up to 30 percent of the space consumed by that document. Thus, until 
you re ready for final copy, you might consider saving your documents using Text Only. This is | 
one of the options in the Print dialog box. 





SAVE PAPER. When you get the dialog box for printing, fill in the requests tor beginning and 
ending page numbers. The last page will not be ejected from the printer, and no blank pages will 
be printed. | 
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REPLACING DELETED LETTERS. Ever use the key to erase letters and wish you 


had them back? Try using the key together with the key and the letters will 
return. (The cursor will even move forward.) 


SAVE SELECTION TIME. To select large areas of adocument, click at the starting point, use the 
scroll box to find the end point for the selection, hold down the Shift key, and click again. The 
whole area is selected. This is called Shift-clicking and is not known by many MacWrite users. 


FAST WORDS. Select an entire word by doing a on it. 


WIDER PAGES. You can have a right margin that extends past the 7 1/4-inch mark. Grab the 


title bar of your document and move the window a few inches to the left. Then use the size box to 
make the window wider on the right side. You can then extend the right margin marker. 


HOW BIG IT IS. Sometimes you might want to know how much memory you have left for your 


MacWrite document. If you are in MacWrite, you can choose the “About MacWrite” selection 
from the Apple menu. You will be shown the amount of memory left for your current work. 


UNABLE TO CREATE A NEW DOCUMENT. MacWrite 4.5 requires at least 11K on the 
application disk Muy. |n document; otherwise, a dialog box stating ‘ [he disk to too full to 
create anew document IS display ed. You may, however, open previously created documents. 


Before you create a new Mac Write document, free up space on the application disk if you need to 
by moving documents stored on that disk onto other disks. Additional storage room may be 
obtained by removing excess fonts and desktop tools. 


Here is a technique enabling you to open "new" documents when little room exists on the startup 
isk: 


1. Free up room on your MacWrite disk. 
2. Create and save a totally blank document onto a disk, preferably onto your data disk. 
3. Whenever you need a "new" document, open your empty "template," then 

save it immediately under another name. 


€ FINDING TABS. If you want to find the key (or change it to something else), the Find 
or Change dialogs do not let you type the character. Fool the dialog by cutting or copying a 
character from within your text and pasting it in the Find or Change dialog box. 

€ VERSION NUMBERS. If you are using a 128K Macintosh, you will be better off using 
MacWrite Version 2.2. If you are using a Macintosh 512K or a Macintosh Plus, you should use 
MacWrite Version 4.5. 

€ LOST? cu lose your riase eode seroiing around in MacWrite, you can find where you 
were by pre ing | nter] . This will return you to the blinking cursor. 


@ FASTER ERASE. If you hold down the [Enter] key while selecting text, that text disappears 
immediately when you release the [Enter] key. 
$ PRINT T AKES DISK SPACE. When printing a document using MacWrite 2:2; you will 


`a the Usk containing the System Folder that is about twice the size 
aud. A temporary print iiie 1s written there. With MacWrite 4.5, the temporary | 
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file requires only 10K, regardless of the size of the original. NO TEMPORARY SPACE is ever 
needed if you print in draft mode. 


MISCELLANEOUS HINTS 





DON'T TRY IT. A telephone extension cord may NOT be used as a substitute for the keyboard 
cord on your Macintosh. 


WARNING. Do not place an external speaker too close to your disk drive. Its magnetic field may 
cause problems with your data on disk. This is zZ important as users begin to attach 
speakers for such applications as MusicWorks and SmoothTalker. 


DON’T ASK. If you’re in the habit of swapping disks a lot and there are a number of disk icons 
on your desktop, you can save yourself some time. After you have ejected a disk that you think 
you won’t use for awhile, put the disk icon in the Trash. The Macintosh will forget about its 
presence and not bother asking you for it. 


MULTIPLE DESK ITEMS. You can have multiple Note Pads (or Scrapbooks) available on your 
disk. Simply rename the Note Pad “Note Pad #2” (or some other meaningful name). The system 
will then create a new Note Pad and only look at that Note Pad file. You can rename any of your 
ober ^on Pads to inat name and look at them whenever you wish. Be careful when renaming, 
hink through what you're trying to accomplish. Also, multiple Note Pads will take up disk space, 
so don’t plan on keeping too many of them. 


WATCH THAT BATTERY. The battery in your Macintosh does more than just run the clock. It 
helps maintain 20 bytes (characters) of information about which ports are used for your printer and 
modem. If your battery is running low, your printer may stop working. If this happens, just exit 
the application, turn off the Macintosh, and take out the battery. The Macintosh then uses regular 
current to get the required information. Eventually, of course, you will want to replace your 
battery. 


RESOURCE FONTS. It’s not necessary to store fonts in the System File. They can be installed 
as the resource font of an application or application document. Once installed as a document 
resource, such a font can be used by someone who doesn't have that particular font in their System 


Folder. 


CHANGING STARTUP DISKS. An easy way to change startup disks while you re in the 


midst of your work is to hold down and at the same time and double-click on the 
Finder icon of interest. The disk with that Finder icon will now be identified by the Macintosh as 
the startup disk. (It will appear in the upper right comer of the desktop.) 


SPACE RACE. Never work with less than 20K of free space on a disk. If you try to print a 
MacWrite document with less space, you ma: ruin the document. You will pro*ably need a good 
deal more tree «nace for vour MacPaint cressions. It would Se a sood idea ta begin to have 
“storage dis<s lor finished work, and "working disks" for daily creations. 


PRINT A WINDOW. You can get an instant copy of the active window by holding down the 
key and the key and pressing the number 4. 


PRINT A SCREEN. You can get an instant copy of the current screen by pressing the 


key. Then hold down the ®_] key and the i... <2y, and press the number 4. 
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DON’T REJECT EJECT. You should always use the Eject option to remove your disks from the 
internal and/or external drive. Other methods may result in a loss of your disk directory or files. 
Better safe than sorry. 


BACK UP A BIT. Always, always make a backup copy of disks that are important to you. With 
the Macintosh, this is a very easy process. Either use the application called Disk Copy or drag the 
icon of the original disk on top of the icon of the one to be used as a backup. Be advised: Using 
the Disk Copy application is faster if you have only one disk drive. (Treat yourself! Buy a second 
disk drive as soon as possible.) 


EASY PRINTING. You can print your documents or pictures directly from the desktop. (1) 
Select the item (or items) that you want printed. (2) Choose the Print option from the File menu. 
(3) Select the appropriate settings (they’ll be the same if you have chosen to print several 
documents). 


SAVE ENTRY TIME. Pressing the key is the same as clicking OK in a dialog box. 


EJECTING. Eject disks by holding down the key and pressing E . If you have two disk 
drives, arrange the desktop so that the two disk icons appear. Type A (selects all icons). 
Then type E (ejects all disks). 


DISK DIRECTORY. You can get a printed copy of your disk directory by clicking on the A) Icon 


to get the window of contents. Select by name from the View menu. Now print the active window 
by holding down the key and the key and pressing 4. 


MOVING WINDOWS. If you hold down the key before you drag a window somewhere, 
you can drag it without making that window active. 


CALCULATOR CALCULATIONS. Cut and paste a number (or a series of arithmetic operations) 
to the calculator and watch it work automatically. You can also use the keyboard to operate the 
calculator. 


FIXING CRASHED DISKS. If you have a disk that is no longer working, try the following. 
Hold down the key and the key while booting that disk. 


é WHAT'S IN A NAME. Disk names must be 27 characters or less. Application names, folder 
names, and document names must be less than 63 characters. Do not use a : ora . in any of 
your names. 


& SPARE SPACE. You should always ensure that there is some space on the disk that contains 
your application (MacWrite, MacPaint, and so forth). This is true even if vou're saving your work 


e De CE, PR to = Ë Ir $2 ^ a1 117 : È e icl- < Di ^ “£ 7 “ ` Š ret 
on an ontrely different dick. The reason is thar MacWrite needs disk space io store a copy of your 
documen: temporary before ct enppts ít ori VMaePuint seeds space to stor: Cll versions of wat 


E 


you're drawing. Keeping SOK to 1UOK of space should be more than sutficient. 


€ WINKING AT YOU. If you see the @ menu title blinking at you, it means that the alarm 
clock has gone off, and you did not know about it. Shut otf the alarm (use the desk accessory 
menu). 


'O3ckspace 





é BACK-BACKSPACE. If you have pressed the key too .. "mes, you can 


1 a . - 
i a a a. 1 k; t . M 
PERDE X TUA, ee E. t “i sure "e d - FIC x 2 ` t 
e I = Í o 
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é ALPHABET SOUP. The dialog boxes that display lists of file names are in alphabetical 
order. If you wpe the first one or two characters of the file you want to find, they will be found 
very quickly. This saves a lot of scrolling. Numbers in names appear before letters. Files copied 
onto the disk appear at the top of the list (not alphabetized). If you rename such files, they will 
then be alphabetized properly. 


é ORDERLY PRINTING. If you are on the desktop and wish to print files from there in a 


specific order, use the technique to select each file. They will then print in the order 
that you selected them. 


é PLAY IT AGAIN SAM. Pressing the (6 ] key as you pick QUIT to exit an application will 
cause your system to reboot. 


MULTIPLAN 


€ In Multiplan, numbers will appear in cells as right justified. Letters or text will appear left 
justified. Recognizing this can sometimes help in identify typing mistakes (such as using an L 
instead of a 1). Do not use commas or $ as part of your numeric data innet. Cells can he formatted 
later to include them. 








€ INTERNATIONAL MULTIPLAN versions are available. Microsott has already developed a 
French and an Italian version of this spreadsheet. More adaptations are sure to follow. 


€ HEADERS AND FOOTERS. In Multiplan, you sometimes create a text header or footer that's 
too long to view in the Multiplan header box. Insert the I-beam somewhere in the header (or 
footer) text and drag it to the right until it bumps into the right edge of the header box. Your text 
will then scroll into view. The speed of the scroll is related to the distance between the I-beam and 
the edge of the box. 


THE INSANELY GREAT OPTION KEY 


é WIDER SPACES. Pressing spacebar while in MacWrite will give you a wider space 
between words. It also will prevent the two words so connected from being split at the end of a 
line. Very helpful when writing equations and such. 








& SWITCHER. Do not bother choosing Always Convert Clipboard when using Switcher. If 
you hold down the key while you are “switching,” the Clipboard will be converted for you. 


' qt =} ` v. T. 1 is ` . Ei; 
cv while choosing Clean Lp tron the 





€ MESSY ICONS. If you hold down the |fptien 
desktop, the icons in the currently active wislos will abge ivimmscives niveiy in ile weit pat OÍ ine 
window. 


€ LONG HYPHENS. Pressing [Shift [Option] - will type an em dash (a longer hyphen: you get — 
instead of -). 


é ACCENTS. The key helps with accents. Here are the possibiliues: 
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€ To geta ~ press -n and then a, o, n, or N 

To get a“ press -u and then a, e, i, o, u, A, O, or U 
To get a ^ press -i and then a, e, i, o, oru 

To get a "press -e and then a, e, i, o, or u 


é QUICK CHANGE. In MacPaint, Ë quickly changes the wa. 


é LEAVE IT BEHIND. When in MacPaint. use the #7! or the $” to select something. Next, 


hold down the key. Now the selected object. A copy will remain behind. 


€ STRAIGHT AS AN ARROW. Pressing while in MacPaint forces drawing to be 
vertical or horizontal. Rectangles become squares and ovals become circles. 


é CUSTOMIZED BORDERS. In MacPaint, holding down the key while drawing with 
rectangles, ovals, and other shapes results in their being drawn with a border that matches the 
currently selected pattern. 


@ FANCY QUOTES. The following quote symbol “ can be obtained bv holding down the | 


ij wer and pressing [. Hold down [Option] to get " (the other double quote). To 
obtain a single quote, press and ], or and ] (for the ’). 


€ MATH SYMBOLS. If you want an unequal sign (+) then try =. If you press 
= you will get the + symbol. 


€ BULLETS. If you use a lot of + when you are typing lists, you can get them by typing 
3 


é FONT/DA MOVER. Holding down the key while launching the Font/DA Mover forces 
this application to begin with a list of desk accessories instead of a list of fonts. 


é DA INFORMATION. While you are using the FONT/DA MOVER and are about to select a 


desk accessory, hold down the key. You will be informed as to how many characters (bytes) of 
memory have been used up by “code” and “pictures” within that desk accessory. 


é SEE IT ALL. While using the FONT/DA MOVER, hold down the key when you 


select OPEN. All files on that disk will be displayed. By doing this, you can more easily copy 
accessories and fonts and have them “travel” with your files to another disk. This is a good wav of 
sending along i font with vour document (a font that another user may not have, 


é 4-WAY CURSOR. In MacTerminal, holding down the key transforms the cursor into 
a four-way Y [100 arrow cursor. Move it where you want and click. 


@ QUICK TRASH. Youcan more quickly trash an item that is locked or in use by holding down 
the key while dragging that item into the Trash can. 
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32-53 


100 


EXPLANATION 

Bus error. Never happens on a Macintosh. 

Address error. Word or long-word reference made to an odd address. 

Illegal instruction: The 68000 received an instruction it didn’t recognize. 

Zero divide: Signed Divide (DIVS) or Unsigned Divide (DIVU) instruction with a divisor of © was 
executed. 

Check exception: Check Register Against Bounds (CHK) instruction was executed and failed 

TrapV exception: Trap On Overflow (TRAPV) instruction was executed and failed. 

Privilege violation: Macintosh always runs in privilege mode; perhaps an erroneous RTE instruction was 
executed. 

Trace exception: The trace bit in the status register is set. 

Line 1819 exception: The 1919 trap dispatcher js broken. 

Line 1111 exception: Usually à breakpoint. 

Miscellaneous exception: All other 68000 exceptions. 

Unimplemented core routine: An unimplemented trap number was encountered. 

Spurious interrupt: The interrupt vector table entry for a particular level of interrupt is NIL; usually occurs 
with level 4, 5, 6, or 7 interrupts. 

UO system error. The File Manager is attempting to dequeue an element from the UO request queve that has 
a bad queue type field; perhaps the queve element is unlocked. Or, the ACUQHead field was NIL during a 
Fetch or Stash call. Or, a needed device control entry has been purged. 

Segment Loader error: A GetResource call to read a segment into memory failed. 

Floating point error: The halt bit in the floating-point environment word was set. 

Can't load package: A GetResourte call to read a package into memory failed. 

Out of memory! 

Segment Loader error: A Get Resource call to read segment Ø into memory fi: y indicates à 
nonexecutable file. | 

File map trashed: A logical block number was found that is greater than the number of the last logical 
block on the volume or less than the logical block number of the first allocation block on the volume. 
Stack overflow error. The stack and heap have collided. 

"Please insert the disk:” File Manager alert. 

Memory Manager error. 

The file named "Finder" can't be found on the disk. 

Can't mount system startup volume. The system couldn't read d 

the system resource file into memory. — 


[01]- 7 
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SYSTEM TROUBLE (BOMB) ALERT ID DEFINITIONS 


Assembly Label Error# Description 

DSSysErr 32767 general system error 
DSBusError 1 bus error 

LıSAddressErr 2 address error 

DSilllnstErr 3 illegal instruction error 
DSZeroDivErr 4 zero divide error 

DSChkErr 5 check trap error 

DSOvFlowErr 6 overflow trap error - 
DSPrivErt 7 privelege violation error 
DSTraceErr 8 trace mode error 

DSLineAErr 9 line 1010 trap error 
DSLineFEn 19 line 1111 trap error 

DSMiscErr 11 miscellaneous hardware exception error 
DSCoreEst 12 unimplemented core routine error 
DSingEr 13 uninstalled interrupt error 
D*'OCoreEr 14 10 Core Error 

L. oadEm 15 Seg ment Loader Error 

DSFPEn 16 Floating point error 
DSNoPackErr 17 package @ not present 

DSNoPk1 18 package ! not present 

DSNoPk2 19 package 2 not present 

DSNoPk3 20 package 3 not present 

DSNoPk4 21 package 4 not present 

DSNoPk5 22 package 5 not present 

DSNoPk6 23 package 6 not present 

DSNoPk? 24 package 7 not present 
DSMemFullEn 25 out of memory! 

DSBadLaunch 26 can't launch file 

DSFSErr 27 file system map has been trashed 
DSSiknHeap 28 stack has moved into application heap 
DSRelnsert 30 request user to reinsert off-line volume 


DSNotThel 31 not the disk I wanted 


mtSetLog 32 Set Logical Size Error 
mtAdjFre 33 Adjust Free Error 


— 
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—-17 


-18 
-19 
20 
21 
22 
-23 
N 
-25 
-26 


-28 


Adjust Counters Error 

Make Block Free Error 

Set Size Error 

Initialize Memory Manager Error 


success is absence of errors 

queue element not found during deletion 
invalid queue element 

core routine number out of range 
unimplemented core routine 


tried to remove an open driver 
DrvrInstall couldn't find driver in 
JO call aborted by kililO 
Couldn't re/wr/ct/sts cause driver 
not opened 
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VolOffLinErr 


VolOnLinErr 
NSDrvErr 


NoMacDskErr 
ExtFSErr 


FSDSErr 


-53 


-55 


-56 


-58 


-59 


0 
-61 
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Directory full 

disk full 

po such volume 

VO error (bummers) 

there may be no bad names in the final 
system! 

File not open 

End of file 

tried to position to before start of file 
(rw) 

memory full (open) or file won't fit (load) 
too many files open 

File not found 


diskette is write protected 

file is locked 

volurne is locked 

File is busy (delete) 

duplicate filename (rename) 

file already open with write permission 
error in user parameter list 

refnum error 

get file position error 

volume not on line error (was Ejected) 
permission error (on file open) r 
drive volume already on-line at MountVol 
no such drive (tried to mount a bad 
drive num) 

not a mac diskette (sig bytes are wrong) 
volume in question belongs to an 
external fs 

file system "system trouble” error: 
during rename the old entry was delete 
but could not be restored .. . 

bad master directory block 

write permissions error 


Disk. Serial Parts. Clock Specific E 


BARBS 


drive not installed | 

riw requested for an off-line drive ~~ 
couldn't find 5 nybbles in 2@@ thes" = — — 
couldn't find valid addr mark 


read verify compare failed. 


ho . 


- u — — -— -— — — 


.po1- 10 


r = —— — 
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BadCkSmErr 
BadBtSIpErr 


BadDckSum 
BadDB:SIp 
WrUnderRun 


CantStepEn 
TxOBadErr 


TwoSideErr 
SpdAdjErr 


SectNFEIT 
CikRdErr 
CikWirEır 
PRWeErr 
PRiniErr 


RcvrErr 
BreakRecd 


MemFullErr 


NilHandleErr 


memW ZErr 
memPurErr 


memAdrErr 
memAZErr 
memPCErr 
memBCErr 
memSCErr 


9 
-71 
-72 


-74 


-15 
-76 


-1Ø8 
-1@9 
-111 
-112 


-11@ 
-117 
-114 
-115 
-116 


- — t — = -. 


addr mark checksum didn't check 
bad addr mark bit slip nibbles 
couldn't find a data mark header 
bad data rnark checksum 

bad data mark bit slip nibbles 
write underrun occurred 


step handshake failed 

track Ø detect doesn't change 

unable to initialize IWM 

tried to read 2nd side on a 1-sided drive 
unable to correctly adjust disk speed 
track number wrong on address mark 
sector number never found on a track 


unable to read same clock value twice 
time written did not venfy 

parameter ram written didn't read- 
verify 

InitUtil found the,parameter ram 
uninitialized 


SCC receiver error (framing, parity, OR) 
Break received (SCC) 


Not enough room in heap zone 

Handle was NIL in HndleZone or other 
WhichZone failed (applied to free block) 
trying to purge a locked or non-purg able 
block 


address was odd, or out of range 
Address in zone check failed 
Pointer Check failed 

Biock Check failed 

Size Check failed 


ResNotFound 
. ResFNotFound 
AddResFailed 
AddRefFailed 


-192 
-193 
-194 
-195 


Resource not found 
Resource file not found 
AddResource failed 
AddReference failed 
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RmvResFailed 
RmvRefFailed 


Scrap Manager Errors 


noScrapErr 
noTypeErr 


Application Errors 


-196 RmveResource failed 
-197 RmveReference failed 
-100 No scrap exists error 
-M22 No object of that type in scrap 


Errors -1@24 to 4095 are reserved for use by the current application 


some miscellaneous result codes 
EvtNotEnb 1 event not enabled at PostEvent 
NoEvtAvail -1 no event available (GetOSEvent, 


OSEventA vail) 


= ee Ze = 
- n ——— — — —- > 


2. et 12 






er (rız) 
98052 X1 oUPId 019698 X08 'O'd 


ES 


WEN 
sir 











JOlLpƏ 1uoj n YSOZU 


EITO 











W.L € 





046*-96S8 (FTO) 
sexa] 'oue|d OIFS98 Xog 'O'd 
uorje10d.07) sÁsSq[V 


'p9eA4eso4 834314 [jy `uorgaodioo sÁsq[|V AQ S861 IyZııkdog 
'[eurduo 

sy} ju 1əƏjsuu. , uodn saidoo dnyaeq anos A0.1389p (q 40 ‘spew serdoo 
dnyorg Aug Si pn[2ur *s[erioquui [[v sofsuBay (e noÁ JI Ayied Jayjoue 
u) uorjequsuinoop peuo pue ure.cioud [eurduo 343 Jajsugeiz ABW 
NOA “Yan umo inod JO} Á[uO ure1do4d əy} jo sdnyoeq ayeul Aew no X 


'SÁSI[Y UlOJj quos 

Woo Uo] pa aurad ¿NOY3lA 11.103 Aue ur utuiBoad 10 apInd S J3SN SIY} JO 
vados ojngla, ip gou ABW no X ‘aug e ye dagnduioo auo uo weldoud 
aj sii SUO Li +A poptrAOGJ4d 4aujoug 07 10;ndul02 suo woaz ure1doad ay) 
scs UU) SVU o | ‘Jaqnduoo ajsuts v uo wesdoid au asn 07 14214 ay) 
oy Wak pe: qgzhia&doo ate 346 41jos popn[our pue apin3 sasn stu] 


93130N 3u3r14do?) 


Og ÚisidA 


HUND SH WS 


4031p8 1U0Jj „ YSOJULIEN 


MITO 


) 





DEREN sdiq, Tyd]aH — 9 1ə1deuo 
7x3], ə[dureç Suidueu?) 
9I88J pu? MI 
J13A9Y pue opun 
Suieog 
Sur ÁS 
FUIFIA{IS 
green TENETE aa quoq ay) Zumpg — G 1mdey;) 


ased pue mo 
J19A3Y pus opun 
733 ulds y Suidueuj 
ypım pue uuo Zurduey)) 
Sunjp^; 1915991809 
Uu01123[9S IFPBIEUJ 
a Pate no 19DBIEUYO E Zupa — $ deo 


MISELNO ZUMO 

SCI Woy 23u13 

Ə WOT MƏN E ZUBA 
quod MIN € 8Sur18919 
quo J 8 3ULAQUIIY 

$yuo y SurAdo? 

aly 8 JUPA 

MOPUIM u01129[9S WO 


6 a * à s. 4 » q * e 9 ? eves eo.» pores 3u1))91) Ze £ Indeyp 
Solty YU0 y 
ABO[OUTULI3 |, JUO 

poe muog YSOJUNE] 1noqy — Z amdeyo 


9ns€LNO FN 07 MOH 
xs eui Jo UNUOJ 
£ è a » xa * 9 eevee “hos. ». a os» IIEU LNOT moqy u 1 Indep 


I " a = < è è * 4 è + * w 8 s " à no » à b * b à ów BP Fe ^ " ñ n *" à <+ uor]onpo: Vw y I 


$3uo3uo^) Jo ə[qu L 


‘guy '1ə99nduro2 ərddy 07 pasuadi] yArurape.n e *usojutoepq pur “uorye1odx0() 
SÁSIVY jo 41europud 8 ‘ONSET NOY PP [ru [enugur SY ur peer SYIEUISPELL 


Au^ uoA WIP 4 UNITA SEA 
[enuew STU], Jun UOA WIP pue J9p4017) utay Aq padojaaap sr A USE LNOT 


y 


uvod 19430 
Aue Aq pasn aq 30u [[eys ae ajos addy vornsaxa para duro) sry IMSBLNOA 
uəuAA “IMSPLNOA Jo uonnoaxe ayi jo wed se ssajun Átotuaul QUI JO 
(sasodind aatyoie 10] 1də5xə) anaysIp Jayqoue oquo pardoo aq 10U [[BYs ATEM 
Jos ajddy “91188. INOJ utt uoneutquoo ut ATUO əsn 10] ə]nqt43S1D 01 dio) 
sKsi|V 07 pesuaot| 94] ‘aaindwog dd y jo stueaBoid payyALiAdo) are saputa 
pue utə1sKS eur 'ALVIS OL ALVIS NOUd AHVA HOIHA HAVH AVW 
NOA LVHL SLHOIM NIHLO 38 AVIN ANIHL 'SIHOIY TVOTITOLTIO3dS 
HLIM NOA SSGIAONHd ALNVHYUVM SIHL "NOA OL ATIddWY LON 
AVW NOISNTOXS HAOSV JHL SALVIS ANOS AU CALLIAYVAA LON 
SI SHLLNVWHV A CATTANI JO NOISATOXA FHL “ISOJUNd YV’INDLL 
-YVd ANV HOA SSINLIA SLI HO ALITISVYLNYHOYIW SI! q9V3O9Vd 
AUVMLIJOS YHALNINOO AISOTINF JHL ONIQHVOSTH TATIAWI HO 
SSIYAXA YAHLII ‘SALLNVUUV M ON SHHYN ONT YALA NOOO T 1dd V 


:NSIP asBa[aI ayy uo Japurg pur waists s apddy apnpput e sn SUtMO[[E 
Juawaaıde asuoot| aya Aq pa1rnbo: sr oray paoe]d st udex8ezxed i'urwotoj eu, 


‘NO. OL ATdd¥ LON AVIN SNOLLVLINTIT T AOSV JHL 
JO ANOS OS ‘SALLNVUYV AA CATTAINI NO SNOLLVLINIT VOTIV LON 
OG SALVLS ANOS ‘SADYWYVA "IYILNANBASNOD HO "TYLNICIONI 
HOA ADVUAAOD ALNVYHYM ANV SHANTOXS AUOD SASLTV ASVHO 
-4Nd JO ALVA UNOA WOU SAA 06 HOA AITVA SI \LNVHUUVA 
SIHL GN MTH HO LN3NG3OV Ida HOJ dHUOO SASLTV OL HO 
YAIVAG AHL OL AGIND SHISA (NV AYVMLIOS AHL AO NANALAY 
OL GALINIT SI ALNWHHVA SINL JACNONO ATCANTH ANY ASOd 
Ald AVINOILAVA V HOA SSINLII ANY ALTIIAVINY HONAN dO 
SAILNVYUNV A ONIGNIONI ‘SALLN VHUYA ON SHMVIN 70D SAS TTY 


AJURE A 





'e1eq peutjep 1əqurnj] Jou ere pur ‘spenurui 
YS0JUTIB A eu ur POQLIISEP ore 7239 ‘AY, *.Xoq 30[BIP, * yo1[9-arqnop, 
se YONS SULIST, ‘83U0} HPA 07 MOTH 01 pə9u no JBUM JO 35001 mouy 
Apeaıpe Áp[qeqoad nod 08 ‘JuTeJIBM 07 IBUS ST 93288] NOI JO 229j 
-I9JUT ISSN IYI JO WSOP] "(SOJUIIB pq MOA Ven 07 MOY MOUN ÁJ rorseq 07 
nod 32edxa op am Ing ‘parmbai st s1uoj ¡noqe 33patmouy [rısads oN 


‘apmi 8 IIEN Y ut pəssnosrr' 1səq 3.18 
YOTYM AISBLNOJ MOGB SP snotAqo-uou Maj Y ITE alat] PE ‘MOUN 
pinoys nod yoy 87U0J 3noqe UO1JBULIOFUI puno1Syoeg əuros $1 31a UL, 
'SU0S8Ə1 04 10] AX888399U SI 3pınd $ əN PIJULIA e 3A91]9 7M "3.1018 
apm s ən srq doo sn sdiay yorym *axeA1jos YSOJUDEA Auenb doy 
19Y70 SB ƏN 01 Asva SB OSB NOY IHLU 0) prey ÁI9A pox40A aary DAA 


'4u0J [[B1 F IJEU o3 
Kq[921149A JO “JUOJ 18J € INPUI o1 Á[[EJUOZIJOU BIMIBIBYI ə1n(ə83Buxə 
pInoo noÁ 08 'etxe 1əuqtə ut Aj3uspuedoput pe[eos aq Leu s1uo q ‘suor 
-813do Ie [TUS JO Surur[jno ə[qnop ur0j1ed uəAə pmo» noA Spaad 
e|A1s quo; Aue dn oun, usa nod 'onseLNOJ YNM uu Apoexa 
00] SÁBMTE 3, UOp &19729.TE2 PIMOPBUS 10 paut mo :s93po posses JY 
W100uis 04 setjt(rqede» Zurjrpe s 91158. LNOH FM USYI ‘pz NO x MƏN JO 
9zis BY} ə[qnop prnoo nod 'Zurjutid 10] JUOJ 8} HAO MIN Yjoous Y 
978919 07 'edurexo 10,4 'Á[[E9IJBUIOPNE umop 10 dn quo] 8 aeos pue (Na 
'PIeq 'sot[e3r) 8199981899 af Aye 03 ANTIQB IQI SEY onse NOY '1»edxoe 
1431 noÁ YY spuwuruioo Zupa quo; ewou aq 07 uonippe u] 


‘quo; Surystxa 
ue 9z1moJsn) 10 ‘tuoj apere asodmd-[ernads B 939245 0j 19sn 
qsojuroepq ATƏA3 10] ASBA y IBU 0? pədo[əAəp uəəq suu INSP LNOA 


"UMO ITIY] BABU 01 I01ID39 1ü0J pazuawmoopun pur Axjeq e 
IEN JO 8398 193981819 P3UUBI ssvysind 07 peq enseojd siy} jo aye vied 
0} FUIYSIM SIƏUAO0 YSOJUTDBA ‘MoU [tur] "193nduroo YSOJULDEJA] 24} 
Jo sa1nseo[d au) JO euo st ‘57U0] 10 ‘5798 19J2B.IBUYI JO I0UBPUNQE uy 


NOLLO(1GOLLNI 





`[(@3əp ut Zurjrpe ssnəsrp s1e3deuo 3uimo[[03 au, 


‘ABMB safueyo MOA MOJIYI JO ‘IAY 19UIO0UE 01 11 IAOW ‘N 
Əurguə: WOY HUTBI 91 Atay NIBQ JUOJ ev 91078 ÁBUI NOA 'Sunipo 1MJY 


‘mus uA4op-[[nd eu? wor spueui 
-W09 3UISOOY) Aq quo; ANFUI IYI 07 10 819328181 JO SUBA 8 07 sottueqo 
exeur Áeur nod Jo ‘deu: siy} moi 8193981879 fenpiarpui pə Aew 
NOX `Juoj 973 ut 8193291812 94} Jo dem gB UMOYS 318 no '1uoj e Bul 
-B004 I91JV (JU0] MIU B 3789. 10) 1uoj pure ari; 3u9j Surstxə ur ISOOYI 
0} NOA smoje UST} MOpUtA UOT329[9$ 1U0J Y UON Ə[U 1u9j v Furuado 
Aq 10 do1xsap au; woul 3t Furuado Aq səyə pexoaut st onse] NO 


JLISVLNOdG JSN OL MOH 


‘BN YIM I53U0U aq 
asvald os 's1euro38no jo LOT Y MOURA Op am 20LI ay} 10] 1[95 1,UBD ƏM 
PUB ‘sIIWOISNI MOYNA SESUIENQ Y UNI 7 UBS IM “YOU SI 3811 ‘spuatsy 
JnoÁ 10} serdoo 3HBUIL 07 NOA TAPU 7, UOP IM (A19A0091 IOISPSIP 10] 
| X81p [BuSo əy} əptg% 798 pue 'uoiqoə101d MOA 10] NSTP əsgərə: IYI JO 
Ados dnx»eq 8 aye A[o1erpeurur 07 NOA ƏSIAp8 IM ‘NSIP SIY} D31231 
-01d Adod you BABY IM ‘ISBT NOW ÆN 0) NOK 10] 191883 P ayew OL 


"uon91edo INEB NOW] PAAL J0U səop mq 'iəpurq 
ay} JO yımb UMOUX-[[9M 8 SI SIUJ, "uoot 19AOJA] 1004 eua? H oo] 
0) 33uey> ABU UoI 8.91188, NOW PO9JEIXI IUO peu 1eAOJA 1uo,] 201 
Ə19U A ASIP Y 0) PIAOUL st 2388] NOW JI ‘pouedo st arty quo: n UA 
9X0AUI 07 SUO uoruA 1noqe pesnjuoo AULOJIQ p[ OA IƏpuLi - `11 PIUS 
‘NSTp SUBS IYJ UO 181X902 JOU PMOS I9AOM JUO Y eq pu? N: INOI 
‘SYSIP FU0J MOA uo IIISBLNOJ YIM 19AOJA] JUO IYI PBJ i nur no x 
‘SEL NOG 10 I3AOW JUO Y IYI IYN Aq punore PIAQUI Áqoa.: od Sv 
81U0j 0$ ‘Ayn 1I9Ao0] JUO Y 8 addy yya Spqryedwos gt 311] «104 2] 


‘19p[o; W3184g əlddy p18pueys əq1 pue ‘( sJuof,, peu) suo] 
[813438 (31A Ə[U E 'urexioud onse INO SY) SUTEJU09 ASIP Fr. jo. ino x 


ASIA AHL JO SLNALNO)I 


OILSVINOJ LAOAV 
L 131deyy 








"xeu 34} WO SUL euo Suroeds JO Aem E se 2 jo qun 157 ‘1371201 
1,usoop Kr[eə1 31 nq “JUSIIYIP st ura? eu jo uotjrugop s,19'[dea30d Ay 
2UI, 3xeu 343 Jo Jepueose ay} 01 MOI JUO JO JIPUIISIP Ay) Woy 
9oeds au) SI JUOJ YSOJUTIBIA] e jo ( ñurpuəl, paounouoid) ,Butrpear, ayy, 


‘(£, 10 A, € jo ut0330q 94] SE tons) JUO] IYI ut Jepuaosep ISA MO] IYI JO 
U10310q 24] 07 eut[98 eq 3U1 VO] 99U81S1p IYI SI JUOJ € Jo UA Sap, au L 


'juoj 9Y} ut IPOBIBWYI IU AMY ou 
jo do} 943 04 eutr[oseq 3YI WOI BDUBISIP JY} ST QUO] © Jo Boose, IYL 


‘UO 1831 
81937281849 peydeo [fe 387) IUN ÁJGULÍBUIT 943 st quoy e jo aul Ase au] 


"4X91 paoeds-a]fuis ut auf 
JUIL 1X9U BY} 07 IU] JWIOSE JUO WON 99U€]8Ip IYI SB 9215 1uoj BY} 
sauyap addy (8891 10 310w) JU3989P pue quaose əU1 Jo WINS AY] se pa 
-Uljap Af] BULIOU st ING ‘IZIS 193IBIEYI [BENJI IYI YIM op 07 Furyz {ue 
JAVY 0} D9240J JOU ST 9ZIS quo] po1e[oep eu, PUJ Jo nuoui 
3718 1X9} BY} WON SIT} TIM JSr[rurgj 91e NOK “UOJ € IVI Jo 199198 01 
SaUTING! ZUIMBIP 3X9} IYI Aq paen st quo] Y Jo ezis quiod prp au, 
‘yout ue jo z//1 Ajoyeurtxoidde jo aouesrp Y 10J WIN 8,1o1ut1d V st 
Aurod, mo ‘u902198 aq? uo 730p V 10 1urod e jo 3dəouoo [eoriviuau1eur 
94} uloJJ PUTISTP st 91əq 3utod y “sjurod Ul parnsuoeui st azis 3u0j UT, 


‘MOPUIM „SV 3ABS,, IYJ ut LaqUINU portrsap 
ayy 3uidAy Aq Buriəqumu orjeuio3ne sty) eprueAo Agw noÁ 'poumb 
-91 J] `Ə[U uorjeutisep əq1 uo 3sixe Apeal[e 3,usaoop uS% üm 007 usul 
1938918 JaqUINU quo; 3xeu aq SHIId 1t ‘quo; mau e Juros USUAL ‘007 
GI 1uoj YIM Burjrgets 8ju10J mau siəqumu Affesıyeworne ISL NO 
`əzts quo; eu? YNM (ə[ddy Aq poudisse) 19QUINU quoj g zururquio2 
Aq jınq st qorqA “əqumu GI 1uoj g SIN qsojutogjq au) '“A[[ruiəlul 


'32391d əuo u%ul1 IIOU OFUT 
yds aq 38nui 31 18ü1 1uoj 93.81 8 qons 3[mq ƏAgu NOA jr ain vay SIYZ 
uo peseq uorquoAuoo JUIUIBU g əsn 01 YUSIM ABUT no X „OMVOIHD. 
P9UIBU quo; Y SB oures 3YI JOU st OBBIUO,, quo; wass ou] 
SNYL `S19119[ 9589 JAMO] WOT PULISTP 318 819339] PENALI 1Fu1 351100 03 
3uv110duit st $] ` nuƏəul E uiodj JUOJ IYI 393138 01 pesn st aurev 110] ou 


` APA, 
pur uuo, ay) ate sojnqujje 1MIBIBYI FUEPHOdAW] 9 "INO 
Aq 198 aq ue) osje Sutusay, * Furpra], pue ‘JUadsap, iuam, 
S}l pue ‘azis s1t 'aurgu 4uoj au; SIP SIMUL JUO JURIT UT au, 


Z 1aidey” 
] 


EIP YY 
renptatput 03 A[dde yorya əsou1 pug ‘uo; aUa ayl O: udde yorum 
35047 :sdno1F om} o1ut [8] 100q7 AIRI am SOSA HI YD YUOJ IYL 


agay S[IRIAP aenya o1ur 138 ot panu + ST 38J2u1 OS 
‘ATTROTIBWOING S[IVap [ƏAƏ[-wO] 11 JO 10] P JO area Say USBI NOA 
JIe31ep ur squoj əjoldxə 03 UPM prat NOA JL soon ,Wusoyu PNW 
3pIsuf,, 119U1 998 JAY op am ULHI SAIN Ray ALOU SIUMIMIOP ajddy 


SUIS jo vonr.Äsn] 
1-7, aandıy 


Up UISLIO 


* 
P 


em + 3uIpe9T 
--------- € que»ser 
ONIS e SUITISEE 


mA 


ewe = 


—— 4 QUo»SV 


=~ — — —— — —  — — —MÀ 
saprai 


‘1219849 sup ut 
auljap 01 3utod are am suia] AUT [^ UOMIBIISN]]I UB sapranid 1-3 Sn Zt. g 


ADOTONTIVHAL LNOJ 


SLNOA HSOLNIOVN LAOHV 
z 191deyo 





musu [eroadg 
oy} wol uodo FUTISSTIA HPA 34} B3ur15ərəs Aq 1uoj V 10 1MIPABUO 
SUISSIU IYI Pa UBI NOX 'MISBLNOA Áq P3I89.19 SYU0J MAU ur mq [eor 
-1ƏA B 10 '81u0] 80jut2€]A prepuejs au? ut XOQ a1enbs P «r 10352 18Q2 
SUISSIW ou], ‘S19IBIBUI pəuuəpun Aug jo 298]d ur uMrp st YOM 
¿19398189 FUISSTUI, au pe[[E2 19329 euo [wIdeds E st 313841 51070] LIAI UI 
pa urjap əq ISNUI SISYIBIBUD [18 JON 3$193291€u2 GTZ 01 dr «vu 100] V 


19129192 94) Jo s1op [BNIB PUB SII TBU JY} uagoA^i^q sutungoo 
xuerq Aq dn uaye} 81 o»eds peny ou os ‘JeW.10J pessaduio» v ur pa.107S 
$1 JU0J au + 1e1d eu? ut pequosop st YIPIM pue utro oq} FurIaS 


J9j291€9qu23 wou ayy dut 
-MBAP 10J 31edaıd o3 1ox.1eur YIPIM eu) JO JUÍTA eu? 01 YSN! pasu gape st 
ued ay} 1970818 Y0 eu) JUIMEIP 131JV ‘198]JO 10 ZutuJex prs; 15156192 
ay} 19Y39YM uo Surpuadap '1urod uuo ayy Jo WA aui 40 39} ayy 
0} UMBIP oq Áeut 193981849 343 dn Zurxeui 830p [en198 L "URLS 
941 07 pardo) 3.18 19329.1€u2 ay} ñuruuəp 830p IYI pue 'autrjosnq 947 uo 
‘quiod ULÍTIO ay] 18 511875 ued ZUIMB.IP ay] *s193591€u2 ui snap vog A, 


`əuo JUALIN eui se Jods eures 3Y) 1? "erp uaqj 
SI 193991€ 2 3xou eu '[o11uoo ULO au jo dor uo [our è: YIPIM ayy 
now ÁA[durts !pəuuəp IQ 01 $1932& TEQ2 (9411181940) YIPTA 0.102 SMOTTB 
o9nseLNO SIIPEIBUI uəəA1əq VdS AIU Y SI AAYY 0s t1: conu IG 
jo uwnfo9 3se[ 213 JO 14311 343 07 uuinqo2 JUO ISBA] Je a: 0] [013009 
yapim ay} 18nfpe pmo nod *Aj[eurdoN| ‘QUO STU] de[IƏA0 [Tt w 10129. 12 VO 
1xəu Jų} (ases ¡ensnun UB) 1332€ I8U2 IYJ JO YIPIA [BN AY] uey} 
$S3[ SI Zut33o$ YIPIM IYI J] 19128J9u2 1xou JYI 9.0J3q pu" 1979P.IBUo 
1841 Jaye 31191 st eoeds ‘sjop 13398.18UY9 y3 Jo YIPIA [enior ay unu) 
4938313 ST STU JI 19129 1€12 13ua4d1n5 IYI ZUIMEIP Jaye 10129. RYO 1X9U 
au1 07 uad FJUIMBAP 34) IJUBAPE 07 YDIYM Aq IDUBISIP ayı SI PIM, 


"ISYIBIEU) snot4a1d ay} Sd8] 1940 pue '4je[ SUII 19329115 PN “Z-Z 
aındı] ut se ‘[0.1U09 UIBIIO əu1 JO YA AYI 07 St JOP 1932: 1PYI sour 
-YƏ IYI JI ((,195]J0, P9][89 st eoeds 8147) 31 Jo peaye aoeds yurıq YIM 
UMBIP SI 419329122 IYI ‘T-Z BIMBI] ut se 'ro43uoo utro (11) Jo 1402141 
94] 03 st JOP INIBIBUI 180u13j9] IYI J] “YIPIM 491294832 P SAS [043 
-UOI 380u11u SLA au PUB “ULÍTIO 19139 € 12 IYI $398 [OAJUOI 190ur3jo| PYL 


‘Zo pu? I-Z samy jo 110310q əu1 Je UMOUS se 'dunrpo 10156182 
ñurmp uas əy) uo s[orjuoo Aq pojsufpe aq UB) YIOG * UYIPIM, 
pue ULSLIO, 318 INOGE 9162 IM sə)nqt1118 1e1281euo [enp'rarput ayy 


Z Jejdey) 


Futura 10309498 ) 
7-7, oma 






dg MMC 


mp UTALIO 








+ t | 
' | 
us en P. er + 1U92S^(] 
cbr —€— e aese] 
o! 
' ' 
' TEN 
3 1 ' 
' ' 
| i 
bi wa + 19957 
| bè 
“A 
"1978 IP YO snotaaid JUI OWL STU M Tey] Lay eu UTI oyl Jo 119] QUI 


01 1a]o€1euo ayy Jo wed ayy, imm miro aya jo ap “I 01 PI] SIP 
19199192 JO suumqoo AJOL IO oro qr pr os JAY IPM Ure au Aunsnepr 
Kq Ayduits 398 st Juua y “Surords 19 199 AP Yo 4910211 sit: MOT! “yal SU 
04 1232€ I8 IYI out spuagxa svp Á, aui JO [EI eu, DM TEUL uuo 
eu1 JO 172] 941 03 SAT] Y Jo aed asnMAA 1JƏ[ SUY A, up 193291842 
pousay e SMOUS Z-Z BINA UWA] tay] 01 AAWEIBUI IYI JO $83]p18331 
Junowe paxij 8 UIJ SIAJ IDU USOJUDEW ©} UO Io[duits 
yanıu aie sSutu] 13pereys stioransd ar uo pas?q 19918» que. 
-Ina ay) Ke[dstp 01 aa ym AHINI 07 agri Burudaw N sasn QUA 
JOVIPS 1x2 petoads g samba stu p aed 1019948q9 YORA — '] san [eA Juru 
-ıay Kjteds yorym 'sepqea Buruy embar Ayde.giod >: Ayıyenb udrg 


1d A} [819U1 JO 
3931d Kum € umop UPUB ur aura 40]eorput [or 28 dunsnfpe 
Aq Surusay Kpoəds uve» noA MUS ‘SAPp osaq1 191SPa Ale säutyL, ‘aL, 
ayy jo des ay} 19pun a[lsau ppnow 0, au1 1ey 08 139473707 pausay, eq 
pinom OL, se qons sated 197137] Aaso 94001 1341980] 1} 01 payojou 
IIAM 8.193773] UIBH 'adÁA1 [rioni uir euop SEM Sunurid usym ‘ose 
Suo] 'sıaypeaeyd SutdderoAo aqraəsap 01 uLt91 s 191urid e SI ‚Zumay, 


uo} a3411ua ay} Sur?ugmo 3.18 NOA 
'saojeotpur 2894) SJUBYI Nos auri LUY "ways Juem NOA 2J9qA 07 WAYI 
Sur88e1p pus asnow ay yim sioyworpul usados Zurqqead Aq SUIPea] 
pu? ‘quaosap UL 'aur[aseq aui Aafueuo 01 noÁ smoje IMSELNOA 


9pint) SSN ISBINOIH 


(sip 
dnje3s 94) 30u) Ysıp a49qqoug uo Adoo e aFueya “t eBuByo 07 usta noÁ 


JH panpa aq JOUUBI ysıp dn1191s ay} jo (Z{-OSBIIYD) 1uoj wersÄs au 


'pejepop eq Jou ABU PUB ASIIPISP up 
yum pay. eu 918 38973 tory ure18ÁAg ou ut paambaı are SJUO] UIE aD 


'Surmu 
sy Sutxor[»-epiqnop Aq Butt1tpə urdaq pue quo; eu) 399198 OSE PO NOK 
*JU0] p3193]98 ay} 3A0UIIA 10 'Kdoo ‘pipa 07 noÁ ao[[e 491u99 AY) ut SUOI 
-mg (120109 Ya] 19M0] 34) ur peAe[dsrp sr UOJ ay} OQ UOT OT] 
-I9U109 FYSII 19MO] oq ut paÁe[dsrp st 3u0j paj2e[es əu1 jo reus 
ad) v `əsnour ayy YNM aureu 1194) uo ZUAI Áq pə15ə[(əs oi" SUO N 


'8aureu jur IO 181] 
au} niyy [0126 Aew nod os po[qgue ate seq [[0.198 'eoeds aq 111 114 0] 
syuoj AUBU 00} 318 34913 JI Ally FEY ut 83u0j [VB BMOUS Mop'i'm au 
pu? ‘mopuim ey} ut 9A1J98 Á[JUILINI ay au) Jo eureu au UN pori 
SI MOpUIM Yoeq ‘Apjuapuadapui padusy> aq Aew əy $, MOPU: v quor 
‘QUIT] QUIBS au] 18 SI]1y 0^3 uədo 03 NOA AO[[8 EMOPUIM I9UUI AL YJ, 


']U0j € 9AOUIOI JO ‘JUOJ MOU E 916919 “SAY uəəm1əqQ SV!) «doo 
‘Sally 3u0] əAtq98 ou) oSuvuo 'Zunrpe 10] 3u0j € qoə[əg 01 NOA SAI e MOP 
-UTM Ə]118S4ƏA STU], 'peso[o st qu0j 8 4AL 10 ‘dn 871838 981 2- NOAH 
uaym poÁejdsrp sr [-g amg ur uMous AODUIA uorjoe[as 1103 PUL 


MOUNIM NOLLIYTIS LNOA 


CALAVIS DNILLIO 
e 1a1deyy 


IERINO 
143n0q 79% 7,USALY OYM ajdoad 01 syqritodsuren are ANT s EN 
wy} NUOJ ımoÄ YA dn daay 07.172 «t 3] "sequ ION pio qoe 
110; MOA (e op noÁ yey} puoutos ay co[u ura Rod. Mo ASIN 
au] se nons 'sa[tj QUO}-UOU UO S]Uei NPI UIAA IP LO QU Es 
xa ut EQUO] Ppa ‘YIFRIIS WAY Soy VIO] MOU aypa ura "SP NO 


tj wags ÁS au} UO $740] pour ATI] FEES NUR OPHILIAO prrv i isti 
1941 01 ATUO o[q 9 [T£ A? IE SPUOJ tons LAOTI SP uons^ comarca 
uonvor[dde 07 UU] Ádo» 03 agresor pepe ST PP osn 40] Ar! re € at 
01 way? &doo pue Ay quo] YP UO Cyto. ume ` dany APULIOT CA Te K 


panado st uoot AY aga uec PAPA 
st tue adogdd 19A0]N WOT s addy 40 otim LNO PUR nc ATO er È 
se 3p ayy Kpiuopt uotum wir. old turas aya Aq 198 o 7 891n QU 
ye pemadg ‘squoy Aquo WEP (JU TSA Soy &qpearsgq oit coqu quoq 


STA INO 


(pañu r ocn yro an FIA eo c "sea dun 
AUTEM Y Uma [ley few suonerado uons AT Sppureq 0] Lion mu yABnoua 
jou SI aaya JI ‘Sean yea} FUITEIS IN augas ‘aysed 79 Mo $ ose LENO 
jo adequeape [mj 248I 01 FP nox qp usojuioegq[ Arou u YSTg * 
ambas Lewu s1u0j acte yons duri poperuap 842312€JP12 j 30] B FIM 
s140} afe] Araa 10} pauınbar Apun st styg, tay your UN sqoqi&s qeroods 
pue 819733] BSB a9moj PUR um 200 IH TT pur sı.::ay [earde» 
and 07 aaey few noA 'opduexo od agar ano uey aoti cU pds eq 
oy $3u0j eie ambas Lew uorin ju oy? mq 'ayuoj [mie u 40] 9218 
«noJattasi e SI STYL `sə1Kq YZE Je 3713 UM PULP 01 polli: aJe SYUO Y 


apino S,19S/1 INSSELNOÍ 
J 








ki 


paweuun ‘Mou 8 uet ‘IZIS JUOJ 8 197JUƏ 01 paxse 918 NOA "MOPUTMA 
U01793[98 1uoj 34] ur UMMA MON I} Zurqot[? Aq JUOJ MIU p 91891) 


INOJ MAN V DNILV3HO 


isrq3 Jurop 910Jeq e19uAeulos quo] au] JO 
Ados e paars savy NOÁ ams ag '9[y 387? urodj peAouia1 AIJE prU! SI 
quo] 94) PUB HO Yolo *uorje[op ay} unruoo 07 payse 91e no X "uoqinq 
3AOWSY IYI HOD uot] ‘31 329[9$ ‘AY JUOJ € WOAIF 300) € JAVU OJ, 


LNOA V DNIAONH 


‘(II 40 'ezis *eureu 1uƏ4Ə3JJID € UM 31 BABE 07 NUU ƏLA 
8 21788 LNO,J 110.1} PUBUTUIO) "SB HABS VY} 380049 UAI DƏ 103 1u0] 
eu? uədo p[nous noA ‘(] 1u0j 10 'ezrs quiod *eurgu aq; adUBY c1 Te m 
NOÁ J] 'pexequinueJ St JUOJ au? 9892 YDIYM ut ‘BT uoreunse: yt 
jo1puoo 3uriequinu 8 st 91343 ssepun padueyoun Ya] st (12 IU], 
"[BULÍLIO əun se əzt8 JUTOd PUB eureu aures aq USALI SABMIE S! * 0 9]. 


'peuniopred jou st Adog əq1 IMIYA "Tun conos 
ay} Aq paveda st e3eor[dnp IYI ‘HO Jamsus NOA JI `11 e»epdod 1 ur m 
NOÁ jt payse are noA ən uoryeursep ay} ut systxo Apeai[e 271 1urod 
pue euieu Iures au] YIM 1U0j € JJ “91943 Apeaıja quoz Aug ur ITY 
-uoo 1,usaop uoruA (JT 7003 anbrun e usAld pue MOPTIM 19430 317 Ul 
3]1] uorjeurjsop IYI 91 perdoo st quo] eu], "uoyynq Adoo eu 40119 pue 
MOPUIM DMOS IYJ O] 9ureu JUOJ BY] PAG AY uorjeurjsap 247 10] 
134740 24) pu? all} 92Jnos aq] 10} ^oputA A] euo uado ‘mopuim von 
-39]95 1u0j JYJ WO "Á[I889 AIBA Ə[U 0) 9[tj LLO pardos eq Áru 81004 


SINOA ONTAdOO 


‘aT uia1sÁs au 3ut1e7jn[? MOYNA SILIMIBN JO UOISIDA paz uo ISN 
ey} Aq pasn aq 07 SJU0J 2804) SAO[[8 api; wedodd 91H A^ "IN 97 
03 s1uoj Sutaow ‘aldurexs JO y ‘Pamba jou st sty} yng “WAU ocn o 
1Əpio ui Ə[U WI. Ag IYI 07 sluoj eAour Ajfeuniou pinom no. s400] 
WSISÄR əy} SUTBIUOI xsrp dnjie1s Ino” uo usəlsÁS paweu 11] IU] 


"MOpUuIm UOTPIAJAS 00] 241 
Ul PaIst] ate SUIBJUOS qt sjuoj AUB pue ‘pauado uaq SI apr i ripae 
au MOPUTM U01393]198 JUOF au? 01 uun3a1 07 VOTING YO YI NU UT 
‘ISI] ay} Wor quem NOÁ aly IYI PAS IUO Jaygoue MƏSUT TI NOS 
08 XSIP ay} pala 10 ‘SBALIP [BUII}X9 PUB [BU L3JUT AY] UPIM JOLIE 


€ 1201deu2 


ey 


4 — DUC 


OL 


‘JETP JUALIN. əu1 UO sə[U JO IST] AY NIYI [[0195 ABUI nox *AAOPULA 
uor129]əs 1u9J BY} AHI] YONU AIBA 8.104 YITUM ‘MOPUIM uorje[es AY 
pıepuess ayy dn sFutiq stu], ‘MOpuim au 1epun uonlnq allg ay} uo 
YJ ‘ABM aures IYI MOpUIA Jay? ur AJL PATIRE au AFUFII UBI no X 


"SIP Ino uo arly e YONS st aay JI apy SZUOJ 
ay} SUTBJUOI MOPUIM 14311 Iyl pur atl] W9ISAG Jy} SUTRIUOI MOP 
-UTM (Jaj Əu1 'pajoapas sop ou pia ‘AWP MSELNOJ Vdo nod JI 


LISCIO, 
ay} UO UMOYS SI 19110 34) pue yal ?u1 UO UMOUS SI əuo 'i'1u9ul IMA 
ay) Woy uad( esoou2 'puooəs ayy 10 YO? NOA aym Ay rys au 
ssaid “say 94] UO HOTS) D3193138 air SALI] OM J] “MOPULs 17a] AQ ul 
UMOYS AIR SYU0J S [TJ WIISÄS FIN) piva pura 34311 IYI ut UMOUS IIE 
SJUOJ SIL ‘papayas st AY euo APVO 1] ain? ayy 1841 urs de 83.178 
MISELNOJ pue “ap 3uoJ aya uade nf atera at st ÁY 1840] SU], 


"MOPUTM uorjsa[as 140] JUJ ur AF AU] ouv 
turooa[os pu? 2882 EL NOI Puruado “quo doyysap usoqurori aun tein 
uoar AU 3u0j 347 Suruado Aq 194115 Hunipa 40] paaypas a. sap vie s 


WI V tt ++ 


MOPUTAA Vou vpo uo q 
i a 






i 


DAA md ` ` 
e 


asn wayshs ini parmhal, 


salq 7065 :210 34109 
9/d IPS Bl 97 ung 


NIBIIAN NEDA 
(ana) ( m 
CD] 
x | 
» 


i € ar 











gb-u03S 
ZI-UDISSNY 
BI HIULIAN 
pZ-S}UDIN AN 
ZI-SUBIN AN 
t2-U10N 
Zi- 
9€ -0119)) 
81-31 Ñempooxg 
syuo j:sfisyiu 


w— 






R CINI, 


(Gavia ^ Fi mon, 
ks f unn, 


[ae s In zi 


€——— HÀ 


ulat“ 


ann Ja! 





Jy $0 IND J 


rmiaads maig qoc a Y 


apino Sar: MISPLNOS 
J 








EL 


Ajea 930u1 dn moys Kou 08 MOTA [BNE 94) UI gəxoq Arif se 
peKv[dsip are 8199981849 pauyyapun 3841 NON 'Z-p 30317 ut UMOUS SI 
£e|dstp srq p, nuaw MITA au WON [ENJOY Sursooys Aq quo; pa ay? 
Ul s193981812 IYI JO MAIA [BNIB UE 01 £e¡derp ayy «Buey Aru noA 


MAIA 
UL9ISÁS oY} FI Sri 301]? SMOYS NUSUI MOTTA IJ UMOP Buying `s3axoq se 
pake[dsip are 8191981849 peutjepu() “UOJ uioj8ÁS 3y} ut pautinp SAB 
Kay se suoryisod 103291812 IU) JO [TE SA0U8 1-p amy ut moptitm IU], 


819}UIVY PUO JO MOLA WNSÁS 
17 ami 








BE 
ZAXMANIS LOGO x E B 


yo 
um; J/143]3P298® ! (010) 
ZAXM | pog 
ANISYÖdONN Talal 
73/1H043028V le e[ e| m| Bm ole] [ojo 








CSLISPEZIO [e| | n| al 5| 0| 390010 

Sop AZ®] E JE 

ayi 1910 scwn/ Br 
y X0/ UMOSG ri 
yornb ayl arar-[ 1 #[-[®] #[>|®| p ı ci. 
FPRENSSOCDORUR ORE 
| 7 edues 81-nWAN EET “= 





ads maia VPI ^?! 9 


pausado 
gt quo e 1o3je paAe;dstp st 1-p amdıg ut UMOUS 1843 IAU MODUILM Y 


NOLLOFIAS YHALIVUVHO 


YUALIVAVHO V ONILICH 
r 191deuo 


at 


'squoj mau .moÁ asn 07 APE” ‘doyysap 
ysoyumem 943 07 NOA SUINI um] ‘dn supa o MSP. NO. MOPUM 
uonoəəlrəs TUO] eu ur uojjnq amd V1 39119 JO 'nuaul 9114 31 11047 uon 
-do ging 341 əsoouo ayyy MEP LENO 1Mb 01 SAPA OM1 1€ IYL 


ALESVLNOA ODNLLLINÓ 


‘siaqunu Raer im pasnjuos 5793 13AOJA JUOH PIO 
s ajddy əouts ‘ggg ULI 1939213 «1aq'unu asn 10U p[nous nos 'TIG 010 
Wor ARUBA ST 3u0j 103 SANTRA pedal yny y “MOPUIM „SV BABS,, 
ayy ut pa3ueyo aq UBD (TI 1u9j pam.aua? ayy, ‘QI 1uoj eu (041002 01 
Auessəoəu SI 11 səurtqgəutos ma STY? 1noqe Kalom 01 BABY 1,U0p Aew 
-iou NOK yey} ABM B YONS ut saaqumu (TJ 400} saye1auad MSPLNOA 


SCI LNOA ONLLLAS 


apy 1u0; mau aj o1uo 31 eS 07 NO 
sor» pue oureu 1u0j au) ed few no aa 'MOpUUA “SB >ABS 94] 01 
su 321 IMSELNOJ ‘PTY Wop mau aya AUEI 19V 'auimmu 9[tj Mau 
e adá} few nod yoga oqut 'poÁv stp st MOPULM I9q30U V 'MOpULM 
SB 3ABS 993 ur UAM INA MIN HI yoy pue ‘nuaw 11 1 ayy uox 
PUBUIWIOS "SB ƏA8S II 95001) Aupo 107 3u0j AULISTY UB Pa]os 
10 ‘QUO; əy} pə pue 'mopula uonaapas UO} ayy ut UONN MƏN 923 
XI) ‘Woy MIU € JO UOA INI] e IAA 31] QUO; MoU P 1^ uonPed) 


Sia INOA MAN V ONILVHTHO 


anna YO 
aya Furgor]o Aq ayapduroo upo NAS ANIM SMOPUTM “US Y CONS onn tnm 
pou. at 3.18 noA ‘ally e RUAS LAY oU 199198 JO “Sy p unnm piri 
yI MS “SIP yuaıınd au} pala «SD yuana ay uo Sat Ie qe 1 
P NAY. [[D128 01 NOA smoje YOUT HR *ODPULA Yoma as op saa 
STU] MODUITA "Sy BABS AU] ur MOTIVO apa aun xor orm 
1u9j 347 and 03 USIAM noX 11 (pa es tI AJU S 
180U11YÍTL ay. ur ep ayy) A rs CEA T mp n pc 
MO 4? UU} 'AOpUTA "SE AAT o CUT AZIO pit IR 
ayy adAL 'nusur ATL ou wo; verda cesa JABS 911 coo 
JARS OF Apral aie noÁ UIAM “UIN no^ JI AZIS AY a ERE 
‘Aulyipa Suting ‘Aupa 10] patton pu" para st o7: “yI qu ees 


əpino SJS WSO 1 NO 


| 





] 
j 


SL 


*XOq 19128J81[2 SU UTYIIM 830p $ A 1:7 P2 
JU} s[[0128 [001 MOLIB-INOJ Sy], 'MOpUIA PPI J9198T8W9 II © um 
98.8] 007 SIMJIBIBYI [[0198 07 NOA SMOJ]B pueu au ‘88918 98271 SRA 
0} 136813 IUI FN) `AAGpULA [007 IYJ UT UMOUS 91€ S[001 197V '" T3498 


“¡pued eq yenf Buren Aq əuop aq UPD 
#umnrpə 39001 os ‘988.19 PUB MB.IP u1oq UBI yrouad au] ‘UN asno au] 
ogeora1 NOA [rjum Jo[09 JVY} qt STOP MBIP 07 SANUTZUOI [louad ay | 49819 
07 IYAM JO UM 01 HIV WON pued 343 Japun 30p IPE CTO aun 
jo 10109 ay} SseBuByo satqow SI prouad eq arya UOTINQ NOU! ayy fut 
88314 IATP [003 Puad eu UNA pəuədo st MOpUIA JIP9 1979": ° IYL 


‘UIPIM PUB ULSTIO 1I9]728J€12 SU 2 msnfpe 
103 s]otyuo) sÁw[dsrp uroj3oq ey) Juo moputm oys Y ^ "tpEal 
pus 'eut[oseq 'quəosəp ‘PUISE Sursnípe 10j slomuoo sAg[dsrp "^m [en 
-U99 9818] eu JO YA] IYI 03 Jen MOPUIM MOLIBU Y `S[001 Au: WRAP Jo 
u013129|88 B SI apis a] atr? UMO(] ` 1904009 1JƏ[ jaddn əy} ui p *epdsip 
gt 19JD8.I8Y) Vy} Jo aseult 9218 enpe UV s [ENE sami 19419 
SI yarym 1939BIBYI ay} Jo o1n32td pe.re[ue ue sAe[dstp Bair ]P_17U29 
a3.18] BU], 'SU0TI998 [VIIA 0JUI pƏptATp SI AOpUIA pa 1919F411'1[2 SUL 
4ureq»?y YUM ZUIMBIP ayi YONUT K19A 8341044 IMOBIBUI € Funıpy 


mopu Sunipy 10398191.) 
gr andy 





japeds men MP3 ^! 9 





comer padi ay] stimo pur 


amoerryo uado Kuw SISO PAPOGA wm cit MORA Ra e Ruri ` Apaatieu 


LILY (ABPORIBYO ay} YN P-P qE p ? nfc nuaur A opc 02; uado 
əsoouo u3u1 ‘MOPUTM MATA JUOJ AYJ TOI} 11 199198 APRILU 8 NPA OL 


DNILIGH HAL IVUVHO 


SIDIPARUS 13110 ar SALEH 
aoe[d 14311 ayy ur st 3r IYI ÁJLAA 01 MATA 19430 211 01 di; pu? MATA 
auo ut 19399182 Y YIGUI UVI NOA NE ‘partito SI MATA IYI IUM PEA 
UIeUla1 SU01199[9S `səxoq AIPRILYD PAPAS IYI UT SOON | MASAUI Aq 
UMOYS SI S19JIB IPUI JO adu 10 TOINULIP) PATATAS IYI ‘Mat ayya u] 


$49]29848qu.;) 1uO,[ JO MITA TENPY 
eb INI 


(ei 


YU. | WE ajaj |? re 












E 


Y 











Vi Bee aa. 
doo ag [aj2|cim/ u = | - | 
ZAxMANISIJbdo $ iss drie lale z PLE 
vmjyfıyajepsge em ariel (2 r]? - 

Zum ME mr ñ ' 






ANLSYOPONW Pasig! tts siae 
LY/IH243028V Bree staal ole Als 


TES 


Eme 











y2in b 24] 


6SLISBELIO BEE DEI. 
Sop AZP/ #|7|Q[2|2 2. Sl _ 
ou? 3210 sdcent Wo AAA: FISM 
n G ovcrngpin . 
`x Xoy umog W v. poe rl lg Yi t 

| tub 

7 


WER 
me: 





| io rr Taye [ dt 

I C Sugli e =. urn o camm M 
|j c jam elre]. isi m 
mec occ TE IMAN ES 3 EE] 





"ieu ads matl ni ald @ 


apint) s48*- puse1No4 





¿L 


1dəoxə ‘JUVY UOTILA $ que qos], PHT] FYIOM STUL 1912€ 1P [Y Ws 
-MI əu1 ut 8348 rein ue1291 E 329[es 01 PÆN st [003 xoq pəusSrp au L 


:19)9818U) o1 1912981802 WON) $838 IR|NTULI 
-991 9)88d PUB IND 08[8 UBD NOX "€S19A-92IA JO '1U0J € QUI pard pue 
jure GIVI VOY MI aq 03 SINPEIBUYI MOTTS suonveedo paaa yg deu» 
3X9U au) ut P9QUIISIP ST AODULA j3rpe zuo/ TXT 34) ut aysed pue ino 
4332D401/7) `ənged pue m 7202]-71Q ULIOLIAd 03 Moputa PPA 4979)" INI 
ur uaym nuaw WPA sy} uro; uotido e389q 10 'ÁdooO ‘MI au? 19298 


ALSVd ANY LAO 


SABS IIPBWYI Y PIP 988] 10 'Zurjtpoe 10j 3t paura ort 
NOA UsUM SBM J! SB 19798184) IYJ 01 Youd NOA sexe) (NUJU ec, Y AYA 
UT) DAS [003 JUGLIMD ay} UNA peurropred NOA uorjeJedo 187 oy} JO 
199539 AY} opun 03 NOA smoje (nueu IFPA 943 UT) PUBUILIOS OP! A eu, 


LYUJAIUY GNV OANA 


"EMOL 
950] 941 1940991 01 pesn aq JOUUB) opun “WO X(də1 nod JI 'ñuluyKup 
goso[ 31 31oJəq 31 dogs o1 ‘(jaoue 9 10 'AumAuR U011819do ou? op 1 NO 
puodsoJ ugo nod pus ‘ueddey 03 Mogu $1 sr Jl NOA SUIBM INE NO] 
u9j 9Y] JO UOISISA paaws Á[snorAeJd 8 0j PIBAVY 07 JALU DINOM 
nok pug '1932€1eu» A19A9 JO SA01 U10330q IO doz eq) 280] pir? nos 
“onun oo? 1u3289p 10 JUIL aq IMPA NOA J] "3189 BABI os Jun run 
QU} S123]J8 MOPUTA [041U02 [BIIJA IY} Ut S[OXJUO9 IYI 01 aur: Auy 


"JUSIBIP 10] ARC, 42 JO 
ed 1s0urjjo| eu uo 10 'Zutpgo[ 10} PEIUMOLIEB əy} uo peuonisod 108 
-m3 34) BABY JNU no 'a1621[9p El [o1quoo nerido1dde ay} Aunenfpr 
‘(0197 SI SUTpwa]) APIDUIO) S[O.IJUO) 1uəosəp PUB Surpeo[ j[ "EMOS." 10 
are SUuIp83] pue surjeseq ayy, SIH Aq pe1eorpur ITE B[OIJU0I ICP 
PUB 7U3988 au ‘MOPUTM [01102 [891149A VY} UI [OXZUOI ayewdoadde 
əy} Sui8Swrp Aq Suipea| JO ‘autjaseq ‘]uaosap PUSE aui UVI 


‘OLE INIISV ONIONVHO 


y Jadeo 


U 11529.4141: 
19YN ut pəAour aq UBD [OIFUNI YIPIM AL 340Jaq YA 343 01 t AQUI 26 
jsnw [o11uoo ULATIO 9U) ‘dejaaao «10102 10q IT ‘YAN 40 ran 
IMIRIBUI IYJ dep4340 03 191208 uo SHJ) aen U NOA IP iocum 
3y1 JO JAI 10 91 ayy 07 S[0J41u0 ry Arummormisod ÁW va M MS 
JAVY 0] AMIBIBUO IYI SISNEI IO 1" «qo do uo s[o.r1oo UT Turina 

"19IIPABUO ayy UT sap art Wes [0.11110 ay dc STO] Uum 
nox os ‘pa8frap utaq st [o1u02 01) aps UMOYS Dam EOU aane] 
"uo31nq asnour ayy 9s?a[e1 UAY nets o] SOU SH 01 (odes uy dame 
-BPJIP OT Um umop 11 poy 'uo11nq act MIT oup] SET TOIU OJIS OD 
oui uo JOSINI FU} uomrsod Siwar APTA AO "urere au] pu OF, 


HLOIM GNV NIDIHO INT ^NVHO 


‘NUQUI MITA 9U1 ut sapddoi HO pray 10 ug pu ayı TM MOP 
-UIM Hp? I9PRIBUI ay} UT PN (nqd«tp. ot prr aun p ayyon aum] ) 


Aue vonon protitaa JO [mr Zuow el 
[001 € ui?11suo2 OF 134329301 uoj]nq Tin oq] PTR ADM uuo esq 


‘81007 BAUBUD o1 FUIAP" INOUATA Auripa anunuoas pug 
Aay uorido au} əspələ4 uou] “yr gut do MYM 01 MOPUEM MI} [9428 
urd nox ‘puey e 07 sadueyo [por rimo om ‘passaad sı £v uordo 
ayy opu puey Fuy pozos r en ae vl 01109 “UP SMO[]P 1 MIOUS V 


PASO st pp USM UIptA UD HUU E 
0] umop WIEq pexoed st 1932€1€ uo AY, vov PU) GEL PUOP "qr 1p 
payu 10 3jop ay} 07 1919€ 1e q» N paix K[[poriguroinv ^73 STOO] 
1nq ‘aut 1uəosəp IYI MOLI 40 HUTT TUNISE 301 ƏA0Q8 A^VJp U >? (007 ON 


'S[IBI3P aow 10} aysed pur mo uo U01798 AU} 995 used 10 
JUNI 10} pej223[98 aq 01 SRAIP IV NIUP SMOTTR xoq p? SEP ayL 


`xoq 10 aulf IY} 
pua o1 uorjnq asnow əq1 ISLAT pur uornrsod Fuipua əu1 H} JOSINI 
au1 FAO ‘UMOP Play UOM asnoct e] TA AUTMPIP WPR ^3 uollnq 
əsnou ayy ssaid pue uonisod Auras ou 03 JoS1n9 941 FAC 'S9xXoq 
1e[n3uv32a1 10 SIUN 3uSreg18 MEAP 02 nod moje s[001 xoq pur: auti aug, 


apint) s,jasp Se 1NOJ 
} 





il 


` 
4 
+ 

L 
i} 


61 


“128 1Q 09 MITA 
pue ‘INYM 01 NI8[Q SAI} 349AU] "197281812 YORS SMOLIBU əsuəpuoO 
ede 1ayimy Apure pe»eds 318 S137I818UYI OS “JNIBIBYI U PO JO 
UIPLM ay) 04 aI] 8 sppe puedxg 'snuaw 3ur|41s 1x9} 19110 sor +01 dn 
MOUS 1,uop 1847 Xoq sty} ut pafe[detp 918 SUOLBLIBA FUI As O], 


‘pawnio;1ad st ZurpAys ayy 'uojyimq WO 9 NOTI» 
nok uəu A ‘pattdde aavy 01 ysım noA 893893 JUAJ ay. ya Su 
nok pue 'poKejdsrp st xoq U01799[38 y nuaw [qeroedg eu; wor ido 
""e[A3g Əu1 350049 'perA18 aq 07 IFUBA IO 1931281819 aq] Jumpa :ouv 


SI] amo 
pass ayy Sunipe Aq 8338] WNI 19470 PUE NJEJ j»epred mou» 
0} Ə[q1ssod 3t sexui stu, "819IBIBYO pejoe[es 07 per[dde aq "1 Hut 
A18 1X9] YROJULDVP] prepuejs AUB AO[[8 SPUBUTUIOO SuuÁ 3s INEP | NOW 


ONTTALS 


-nuaw JPA sy} uio1j pueuruioo [TW PA eui doo» 
Áq po199198 aq ÁBUI 3u0j au] ut 819398192 [[V "197981840 Burp mau 
BY} 03 1081n2 ay} SUIAOUI ƏJIuA Aay 3jtus au SutssaJd Aq pəpuarxa 
oq Aewı U01393[98 1ua.mo eu p "uo31nq ISNOUI 9q1 uo dn 3u13)9] 10129 
I3RIEYI Furpua əy} 03 FurSABIP pue uojjnq esnoui əy? ficus aI d 
uəu1 191981819 BUIZABIS BY} uo 1os.mo eq] Suruontsod Aq pap 6 aq 
AQUI SIMIGIEYI Jo əñuwi y 'uoyynq 3enow eq FUTHIT]I PUB 3r ue COS ANO 
ayy Suvuorjisod Aq mata JUOJ eq WO PAIA SI 19FIBIBUI a} MIS V 


"uongJedo euo ut suədo pug spares "j^ 
“13IJIBIPYI eu? Surqoi[»-e[qnop Aq euop st Surjrpe Ie ego (nen 
mq 'Sunrpe 10} 31 Furuado a10jeq pej»e[es eq OSV Jenu I "iUo 
V "^oputA JUOJ aq ur $193281euo Butreə[ə 10 “Bury Aye “Burád: un 
-19 3.039 ATESSIIAU st 81o3291eu2 JO IUBI 10 19729182 € Hu APG 


ONLLO^UTAS 


LNOJ AHL ONLLIGY 
G 191deu2 


8 


‘unde a3sed pue ‘lop 1931403 ap Pe card ayy opun 1 c» no ` 
QIAYM LUSI e1ep parsed ayy JP vain palpa prout 1701 pop sT EEP 


parsed 241 ‘pa109[as SI Bale ABLNAUL LOY H paura6]4əd Cp. [eos nu 
pur 10p yey}? UM pause ST UCDTIPH'! rye poisnd oY) jo fama 171 doi 
ayl 'Runsed 34019q papayas st 310p E 0n nmm MATES p JH ot oun TP 
Way 311 01 83] € 28 pug SPA v onto tpi JO TIULIO O jb doy Djl 
UM gyep poised əy} Jo Jauo) 149} doo ayi sure 93894 7127 yep Ag 


(SINZWNIOP IUTRGIBJAT se unns) Seg corpo MUT TO RIP INU JOUR 
on pajsed aq Aew Bare jn» ayj, Y trap) 10 ‘£do no VU no 
‘AIR UP SUTIAATAS LAY "pa[P2€ de p 7 Mp oq INUUPI SHG peoos UI 


epint) $,195N ` SPINOI 


, 











LE 


Jouloo JUS 19MO] 831 Ut xoq MOLI əU1 
3unsn(pe Aq 1ə[[gtus 10 193.18] opeur aq Aew Has mopurm e|dues eu, 
"MOPUIM STU) 0ZUI USIAMA NOÁ 1xə1 Aus ad UVI NOA 08 ‘MOpu!m a¡dures 
99] ut 9A1J98 SIE spuwururoo Zuppa 3xej UYSOZUISENI PIBPUPIS ayy, 


LXIL TIdWVS DNIONVHI 


193194 Iy} SB 10398] "ums au) 
Aq paes SI YIPIM eu, “JUOJ UOIJBUIISIP 34 JO 3usreq A SAYOIBUI 
143194 MAU 1194] 08 P3[898 9.18 81919818 YI paysed ou; ‘sed e Furinq 


qt 1nd 01 
ooe[d ou st 3134) əsnuoəq P310U31 st [ey u10310q eu ‘parsed -! utunjoo 
aya jo Jeu dor ayy Aquo ‘umop ÁBAJ[BY Surzrejs 1uoj əun o ' 1! merd 
mq s19128.Teuo Jo uurnroo ¡ny e Ados noA jt'e[durexe 404 Po True are 
Kəun1 '81932€18u2 IYI NEVA o1 YIYM ut S[QBIIBAS əəgdsou PH 
"seq parsed sr SUOISUQUITP SUBS IU) UNM dus. enum» pardoo 
SEM $19329J91 JO oSuv1.req2ue2e1 B J] '19q981Iguo pejoopae — rt in SUI 
-1?18 340] ay} o1ut paysed o1e 19]nq ejsed ayy Jo 87USZUO - >| "NUS 
ypa əy) Wor uorido 33884 əu1 3980049 pus 'ojut passed > 011101] 
-180d 19329192 Burung aq 129198 ‘JUO] eu ur SIMIBIBUI au Sed oL 


"uoz 947 ut peurjepun waui Suryeuw 
Aq «19329191 IYI LIBII Mq ‘Ado 8 IHEU JOU BIOP ABA COPAY 
para198 ay} SIVA pue Adoo € soeur IND care AI, s? + ERY 
panajəs ay} saABa] mq saq awed ayy ut Ádoo e s: «i «dog 
UO NPT aw woy yng 10 Adog əsoouo uayy *perdoo eq o1 i noe reto 
aui 2199198 3811] ‘STU) OP OL ‘QUO; I9UZOUE JO QUO] Jay) SUI oe 
poised pue 1uoj 8 jo mo 3no aq Awtu 8191981801 JO e8u 10 12108492 V 


ALSVd ONY END 


‘quo; aures eu? jo U ' r Aq 
P3MOT[OJ JABS MOYNM JOJI BSE 3UIES JYJ SHIOM Y] uuo p nons nod 
QUIS JUO IYI 01 speui BadUBYD [8 ABMB MOJ] 07 NOA SMOL 7 LINARM 


şs 1230849 


oz 


'auopun eq JOUUBS opun adry? styg ur paqtiosep sam99j OU} [TE 
SOPNIOUL etu], '3u0j au 07 opeur adu eu» ISB] 99] JO P IF 99810494 
OPU(] 'ƏA1138 SI MOpUIA JUOJ IYI USYAA MO NIOM 1 UPIP YOY SEPI 
10 SOXBISIUI WOT 19A0091 AT[NJa0".3 01 NOA MOTE PIAI PUB opun 


LYUJAYY ANV OANA 


`xoq Jey u 1979BIBYO MI Atsnotaaid au 
ased 'Áreut] '193291€12 UONBUNSAP at ut Xoq uonoəəlas JO ?718 panrsap 
au) MBID ‘QXAN PALIH aq 01 IIVI AUT MI PBNA COP pULA FIPO 
JaeIeY ew ut ə[IqA) uotre4ədo med pur mo IəAƏ[-11q 94130 91189] 
#urreos ay) Buisn Aq əuop aq 189 "rn? TOT P Jo SIT MAJ P 'enf Sur eos 


‘831 
uey? ssə[ pue '( uey} 1912219 aq WNW saquinu YIO| “SA -quinu om} 


əu1 JO ore aq; UO paseq st Furos y} 13218 TALIM IY vnus 19]{RUWIS 
10 Jafie| aq ABWI AZIS MAU aqu] [n 92 UT URY] UO» .ITp suo Ul 
aJotu ərgəs Aew noA os ‘Ajayeardas pa1oquo ale səzts [9911194 PUR [V1 
-UOZLIOU IU] AZIS MIU € JOE SYSE PU" 1110] 34 JO IZIS JUNTO IUI ST[21 
UOTUM paKvqdstp st Moputa v "nun a] 419 aut WOI] purri I0 7100, 
afeag ayy Fuisooyo Aq Áp[eorgguro1n e paes aq ABUL quer aqua sau, 


ONTIVOS 


uore.iado nio nn arma an 
au uit Surpassoid ‘sop St Au o pra op te ite 
“Jean rruone UI9MIIG QITOYI P tal prin uaddey ay Aer | 7 
star yorum pe&e]dsrp st xoq Var cis mono STA JE A 
JYI JO u10110q 10 do} 941 BUIO moya uonriado RuN p 
au] uuiojiad 07 pews 007 aq Arın gung p jo yumasap 1 rant | 


Harte 
UOTPUTJAIP 1919814602 [RUTSLIO AYI CAPO] qotr as teu mares o p vt ES 
qayo ut ñuqÁqs exr[un snul “I uns 0nsmpLNOSJ UU Hes OS 
utopuf Aq ydaoxa “y ayÁysun onion NOA ‘payAis UJA ri rap ape yy | 


up ia¡duexa 103 3tp3yr 10d ns. to 0108 fad ns) sonno curse 
P AMPUL UBAD O DU) € u Ant a CU Gn faq ey =” a d i 
Autis apu 07 NOA SMOJE SHEL ^ Motos ETTOTIPEIPA a ds 
INO 51.17]8 xoq u01199[9S AY) AU IP APO SRA DES ATTY TOU 4 


aping $40") INSELNOJ 


} 





— — as - 


— . —u xa 


£c 


"Á[gnoauv [nuits 
Kay 212430 ay} pue uondg sseid uesu 3dQ UNM Bues 
gəpoo 'Á[8nO9UBI[NUITE xoq eu? ur 19119[ 19470 34] pue uond() pue 
UTISS ssaıd uga Q-H YIM Zurzre3s sapo|D `xoq eu? ut 19739] 1910 ay? 
ssaid uay? “y30q dn 301 ‘23439307 ysep ay) SurMoj[0j 19719] a' pue 
uondg sseid uvaul -O «t4 Funes sapo 'seouenbes Aay oj nu 
galmnbal Jey IYBLI ay} MQ 's193981812 snotAqo IYI SMOUS 9[q1 IYI JO 
JEY YA] eu] ‘3U0] eu 07 sdeur preoqAay ay} MOY EMOS T-9 IM Sq (9 


swaggqoid 01! JABU 
pinoys nod “uoryrred 19YNIMG euo woy serdoo 10 SIAVE OP Á[uo NDA SP 
Suoy sy `pəKomsəp Arre aq I[1A 31 ‘alt; eq} 01 doo 10 ayıım no * aun 
puoyas ay 08 91188. LNOJ Jo sardos ejdrmur ay] usemjeq uon OIYO 
-UÁS ou SI 9494], ‘WOIpT Ted sayaang euo UB YY 91our ut peuado +1 p 01 
g1uoj Adoo 10 e1rpe ax eu 04 3dure31e Jou OCJ 'Á[SNOJUBFNUIE INS VOLI 
jo Adoo auo usw slow Furuuni jt snotjngeo AYNA PA 1 ui 
-u10281 St EM9SZ 10 {HST Mq “ANGST st YUM UNI UBI INS NOS 
ALOWAW jo Junowe tumuurutur eu], `190914AS JO uodo pir dyo 


119AU09 SÄBMIB 34} V998 NOA a1ns ag 'I9tgeə qonur quredov] oiy 
ased pue gno IIPBIVBYI SIBU 19449807 JUIBQOBVP PUB ori NOA 
$uruunjg SIN EMZTS Y uo e»uo ye sweldord [eieAes UNI nei 


SMO[[? 19UYITIMS "urgaso1d JOYIMAS, IU) YYIM BNIOM ITISELN: F (G 


9 191d8u2 


“apqussod er yontu se sadpa sit 11100U18 
pue ‘asn nok Aug Jo azıs ay} 921A] Tiny Y VYE <£emn e Buried ut 
uot1n[osaJ 3s9q IYJ 104 ‘(Jo e[qe dv» st 1? pad aqy ue vorne" 1889] 
yya pəturtid aq {ra mq) dn moys sarttırın aui os ° ZT-JUoJÄN, © "nop 
1mutid Əy} (pz 3u0JÁJN, € savy 2 UOP nox J pe-woyAyy, ^ u€uo 
osqe noÁ ssajun andino pegurad ur dn Aou you [TIM sasueyo Ino . 'NSTP 
au1 uo pz 1u0JAIN, peureu quo] E aary Pur ' #1-Auo KN, porum quo] 
e əñupuoə noA JI uorin[osad Furpurad pas atout 10] 1UN] par d- p ayy 
JO 9215 34] 92143 WO} € asn 01 satu sayid ay} 184) 49quISuI»y (F 


'snuaui JUN] SIMM 
YITYA 318M3J08 usojuroej( Aue ui stua 01d asne? Sayseys 10 səsə} 
-uo1ed “e nəmaed uy ‘seureu quoj Ut SIMIPARUS jewads asn una (€ 


‘msed #uump 
spaya Sut[e»s [eroəds 19470 799 o1 adrjurApe 01 Ərn169J BULISS AY} asn 
ue) noc ‘y pue1s1epun noÁ auo 143191 947 se suorj1odoud sw es əy} 
Aq Kijeoryeuro3n? PALOS st uqptA eu, ‘3103 IYI ut 19939] K19A93 103 Sut 
-peos 1edoad soaquBrend sry} *3uoj uorpursəp 2UI JO yyy 1104 eu 
oqut (SAUITapInd Zurpngour) 19979] Mo 911 19 1UStay [my ou so[e?* ased 
əu1 VUIS 'edeus 19739] IYI UNA seui[oprn Zi 1u398s23p pue yuaos” aq JO 
asard |[eurs e epn[»ut pue 'ossep ou] ut 49119[ YORI MY uaasop pue 
1uaos 10] sout[optna MBA '1ute qo? MOL SPNA FUI 30H (Z 


perpe UIA BABY SPUOJ [RAIA 1919 dn mous Á[uo ‘'[ensn 
suiajqoid ayy, JULI pue 38V | NO Auryıınb Aq po1227402 aq 
ugo Aj[eusoU pue 'sjoipjuoo gouds Louin Aq pasnes ale su») [qoad 
əsəur Juag pəztsəp e Mpa 01 Kip qu o (prajsut quo; Sua) 
paurusieur e ut pafe{dstp 8437 3t) MOPura TAON Oy Wo PRIA] BABY 
nos 11107 943 Jo aldures 8 998 07 APPALT" um ME stuə[qoid ua < uajo 
3504 aq], “stua]qoud euros INVI Apu siti agin OVW MBZIT TO A 


SdLL TOY UTAH 
9 1Jəlcie'io 








Zurddepy pon voy 
[9 amiy 





M FRAMED "arten 
ol | iol stl aols'ol ol 2 DER 
140 O:$ | 1401 140) 140 no 
sehen TUIS 
a ee 
uj A E 
ERRE Jon 
HERMERPBBBOEEEE 
ce RA 





es 149 
f RSS 
O-$ | 0-35 os 














Only the banner line and the first line (up to the first 16 bytes) of each packet will be shown. The 
display can be scrolled as before. Choosing the menu item again w'll change the display back to 
long format. This item is inactivated during a recording session. 


When Receive LAP Control Pkts is selected, all LAP control packets seen on the bus will 

be recorded. These are defined as any packets whose LAP type field is $80 through $FF hex 
(most significant bit set). Such packets will be recorded only when this option is selected. If 
their reception is enabled in the middle of a recording session, any LAP control packets already 
seen on the bus will not have been saved. Changing this option while viewing the display of a 
previous session will have no effect on the display, but will affect the next recording session. 


Selecting Write Packets to File will cause Peek to save away a copy of the display into a 
file on disk. If there are disks in the internal and external drives, Peek will attempt to write to 
whichever one has more free space. The name of the file will be "Peek Buffer 0", unless a file 
by that name already exists; in which case Peek will try "Peek Buffer 1" through "Peek Buffer 
9". If those ten files already exist, Peek will give up and display an error message. 


If there is not enough room on the disk to save all the packets, Peek will write as many as will fit, 
and notify the user that a "Write Error: -34" occurred. This means that the disk is full; you may 
wish to put an empty disk in the drive and try again. The file containing saved packets will be of 
type "TEXT" and creator "EDIT". 


As an alternative, you may choose Print Packets on Imagewriter. Connect an 

Imagewriter to the modem port (not the printer port) before selecting this item, and Peek will 
print the entire display on the printer. (This could be a time-consuming process if there are many 
packets to print). Note that the Short Format option (described below) has no effect on 
packets written to a file or to the printer - long format is always used. 


C € Contro [ZI search 


Cut 36H 
Copy %C 
Paste %U 





The Edit menu is used only in conjunction with the Find Pattern feature, described below. 
It allows you to use the standard text edit commands to create a string for which to search. 
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° the packet's arrival time T in milliseconds (measured relative to the first packet stored in 
the queue); 


« the time since the previous packet's arrival (delta time or AT); 

e the packet's sequence number in parentheses (in the order in which they were received, 
starting with zero for the oldest packet in the queue), 

e the o length L of the packet (number of bytes in decimal, not including the 
FCS). 


Following this banner line are two displays of the packet's contents, in hexadecimal on the left 
and the corresponding ASCII (if printable) on the 
right. A period is substituted for any unprintable character. Note that the FCS is not shown. 


On the right side of the display box is a scroll bar which is enabled whenever there is more to be 
displayed than will fit in the box. The user can scroll through the display of packets by using the 
scroll bar's up and down arrows, or by dragging the thumb. Clicking in the gray area above or 
below the thumb shifts the display backwards or forwards one complete packet at a time. This is 
useful for scrolling past large packets. 


Menus 

















(MS Control! Edit Search 
About the Peek Program... 

Scrapbook 

Alarm Clock 

Note Pad 

Calculator 

Key Caps 

Control Panel 

Puzzle 


The Apple menu, as usual, is used to invoke a variety of desk accessories. Choosing About 


the Peek Program will cause Peek to display some descriptive information, including the 
version number and the size of the queue in bytes. 











Edit Search 
Short Format 
Receive LAP Control Pkts 
Write Packets to File 

Print Packets on ImageWriter 






The second menu is the Control menu, as seen above. When Short Format is selected, a 
check mark appears next to the menu item and packets are displayed in a more compact form. 
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Notes 


1. The newer versions of Macsbug (1/1/85 or later, with symbols) tend to slow Peek enough 
that it will frequently overrun. Use older debuggers on your Peek disk or none at all. 


2. A node running Peek is in listen-only mode on an AppleTalk network. Such a node does not 
participate in the ALAP protocol and does not even consume a node ID. In fact, it is 
"invisible" to other nodes. 


3. Peek does not use any of the standard AppleTalk drivers (e.g. the Macintosh Protocol 
Package), but assumes direct control of the Macintosh s AppleTalk port. However, the port 
is reset when Peek terminates, so it is possible to then run other AppleTalk software without 
powering down the Macintosh and powering it up again. (Note that this is not true for 
versions of Peek older than V2.0). 


4. Peek will not run on a Macintosh XL under MacWorks. 


5. If a packet that is longer than 4095 bytes is received by Peek, its subsequent behavior 
becomes unpredictable. If Peek terminates abnormally during a recording session, there is a 
strong probability that a node on the network has sent a packet of illegal size (e.g. a node 1s 
stuck in its transmit loop). 


Acknowledgements 


This program borrows ideas from a former Lisa WorkShop application developed by Jim 
Nichols and Steve Butterfield; in particular, the circular use of a buffer. AppleTalk Peek is a 
completely new program designed to exploit the Macintosh user interface. Thanks to Mark 
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Find CRC Error 
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Search is Not Case Sensitive 


The Search menu is used to look for a particular hexadecimal or ASCII string within the 
recorded packets. Selecting Find Pattern (or the equivalent command key-F combination) 
will cause the Find window to appear, as in Figure 3. Select Hexadecimal or Ascii, and 


type in the string for which to search. The standard text editing features available in the Edit 
menu may be used. Hex strings must be a sequence of bytes, each specified as a dollar sign ($) 
followed by a two-digit hex number. In either format, a wild-card may be specified by the 


command key-equals sign combination. This will appear in the Find window as "2", and will 
match one or more characters of any value. 


When the string has been entered, hit Return or the Find Next button. Peek will begin 
searching from the first packet appearing in the display box. The display will be scrolled down 
to the packet containing the string, if found, and the string will be highlighted. Otherwise, Peek 


will inform you that the string was not found. Selecting Find Same (or the equivalent 


command key-$ combination) will cause Peek to look for the next occurrence of the same string, 
starting from the current packet. 


Find Gverrun, Find CRC Error, and Find Timeout work in a similar fashion. 

Selecting one causes Peek to search, starting from the first packet in the display box, for a packet 
exhibiting the particular error. If found, the display is scrolled to bring that packet to the top of 
the box (unless it is too close to the last packet to scroll up to the top). Since the error counts are 


cumulative from the time the START button was pressed, packets with errors may not always 
appear in the queue (if they were discarded to make room for newer packets). 


The search can be made case-sensitive or not case-sensitive by selecting the item Search Is 
Not Case Sensitive. The menu item will display the current state of this option. 
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Figure 2: Peek Window (Display State) 
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Figure 1: Peek Window (Recording State) 
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Figure 3. Find Window 
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Menus and Commands: 


Poke's menu bar contains four menus. These are: 


| € File Edit Tools 


Each menu and its associated commands is displayed and described below: 


€ 
Menu: 


a. rie Edit Tools 
All About Poke... 
february 13, 1995 


999994 mp mmn s. 










Scrapbook 
Alarm Clock 
Note Pad 
Calculator 
Key Caps 
Control Panel 
Puzzle 


The "Apple" menu allows you to run an available desk accessory or to examine Poke's version 


information ("All About Poke..."). Selecting the "RII About Poke...” command brings 
up an information window. Clicking the mouse or pressing a key causes this window to 
disappear and Poke returns to its original state. 
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AppleTalk Poke 


Version 3.1 


Gene Tyacke 
Network Systems Development 
@ 1984,1985 - Apple Computer Inc. 


AppleTalk Poke is a Macintosh application designed for use by AppleTalk developers. It 
allows the user to edit/create packets and to send them out on AppleTalk. Developers are 
expected to use Poke to test their protocol software/hardware implementations for AppleTalk 
products. Poke uses the Macintosh Protocol Package (MPP) for AppleTalk access (details of 
MPP are discussed elsewhere). This means that the system file of the boot disk must have 
AppleTalk Installed (e.g. with the Install tool). This has been done to the disk Poke is on. 


This document describes the features and use of Poke. It is not intended to instruct the user on 
the capabilities, features, or specifications of MPP or of the various AppleTalk protocols, nor 
does it discuss the normal use of the Macintosh's standard editing abilities. (For information on 
AppleTalk protocols, see the corresponding specification/description document.) 


Startup 


After starting Poke, the MPP driver is loaded in (if it isn't currently in memory) and the main 
window is brought up (figure 1). This window displays the Poke station's AppleTalk node ID 
and packet information. At this stage, the packet information indicates that no packets have been 
loaded into Poke (packet names are all set to empty). Next to each packet name, there is a pair of 
buttons labeled EDIT and SEND. Initially, all SEND buttons are dimmed (inactive) because no 
packets have been loaded. The main window includes an area for displaying any appropriate 
error Or status messages. 


The program operates in two different states. When started up, it is in the send state with the 


main window displayed. When any EDIT button is pressed, it goes into an edit state and the 
packet editing window is displayed (figure 2). In this state, the selected packet can be edited. 


Clicking the edit window's 0K button will return you back to the main window and the send 
state. 
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"Clone Packet” can only be selected from the main window. When selected, a dialog box 
appears which asks you for the name of the packet you wish to copy (the source). It also asks 
for the name of the packet which it is to be copied to (the destination). The names are searched in 
a top to bottom fashion starting at the top left corner of the main window (figure 1). The fırst 
packet whose name matches the one you entered will be chosen. If both source and destination 
names are found, then the source packet will be copied verbatim to the destination. Otherwise, 
an error message is displayed. 


The "Show Packet Length" command can only be used while editing a packet. It returns 

the number of bytes in the packet's data field. This count does not include the packet's header, 
so the actual packet size will 

be larger. (See the AppleTalk protocol documentation for information on the size of the different 
headers.) If an error is detected while computing the length, an alert box will be displayed 
indicating the exact location of the error. Note: If you have entered more data into a packet than 
is allowed by the corresponding protocol (LAP,DDP,ATP) then Poke will truncate the data (at 
the end) to the maximum allowed value. 


The “Helpful Hints” command allows you to obtain a quick summary of editing instructions. 
Clicking the mouse or pressing any key will return you to the currently active Poke window. 


Packets can be transmitted repeatedly at user specified intervals. The number of tumes a packet is 
transmitted and the time interval between transmissions are set by the user by selecting the "Set 
Repeat Factor” command. This command will allow you to change transmission 

information used by the SEND command (discussed later). 


The delay time interval between transmissions is given in ticks (1 tick = 1/60 of a second). If 
you enter a number of transmissions value equal to zero, then Poke will keep sending packets 


out in a closed loop (i.e, indefinitely). When Poke is in such a loop, you can stop the SEND 
operation by either clicking the mouse button or by pressing a key. If you wish to send packets 
out at the fastest rate possible, enter a zero for the time interval. If this is done, packet Statistics 
will not be displayed in the messages box. 


Note: The user specified time interval is achieved only approximately. Network loading and 
ALAP overhead plus packet transmit time add to this interval. 


The "Abort Send If Error Occurs” command is used in conjunction with the SEND 
operation. If selected, a checkmark will appear on the left side of the command informing the 


user that this feature is active. Now, if an error occurs while sending a packet, the SEND 
operation will abort To deactivate this feature, select the command again and the checkmark will 
be removed. This command is especially useful when large numbers of packets are being sent 
out. 


The last command, "Calculate Checksum", may be used in the edit window to replace the 
existing DDP checksum field with an updated checksum. This command is only valid with 
packets utilizing the DDP long format (LAP Type field $2). 
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File 
Menu: 





The File menu allows the user to load from (or save to) a file of 10 prepared or canned packets. 


The Load and Save operations follow the standard conventions for file loading and saving. 
Note; Older versions of Poke utilize a different file format. You cannot load in packets created 
by those versions. 


Edit 
Menu: 







Tite Tools 
Cut 36H 
Copy #C 
Paste XU 








The Edit menu is used only while editing a packet. Please note the keyboard's optional 
command keys that can be used to invoke this menu's co 


Tools 
Menu: 












Clone Packet 
Show Packet Length — 36L 
Helpful Hints 36H 
Set Repeat Factor 368 
Abort Send If Error Occurs 









E e iniziati 


Calculate CheckSum 
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Entering Packet Data Information 
The following format must be followed when entering information into the packet data: 


Data bytes can be entered into the packet in two ways: by typing in the ASCII character 
corresponding to the byte's value or by entering the byte's value in its hex form. 


To enter the hex form, type a "$" followed by the two digit hex number (e.g. $84,$01). Note 
that "$1" is invalid, you must enter "$01". Byte's whose value corresponds in the ASCII code to 
a graphic character can be entered by just typing in that character. Example: to enter a byte with 
the value "$62", type "b"; for "$42" type "B"; for "$31" type "1". Other examples can be found 
in figures 2 and 3. Note: Since the dollar sign ($) is a special character, you can only enter it in 
its hex form "$24". 


Poke will detect errors from the end of the data back to its beginning. 
Editing Buttons 


Various buttons in the edit window control the information that constitutes the packet. Each set 
of buttons is described below: 


Packet Type: OLAP ODDP (€) ATP 


The Packet Type buttons are used to choose the header type as described in the protocols 


document. After clicking on a button, only the fields appropriate for that protocol type will be 
shown. The default is ATP. Only one button may be selected at a time. 


OReq ORsp ORel 


These three buttons are only used for an ATP packet. They are used to format an ATP request, 


response or release packet. The defaultis Req. As above, only one button may be chosen at a 
time. 


[Ko []EOM []STS 


Each of these check boxes represents the corresponding bit in the ATP control field. If checked, 
the corresponding ATP control field bit will be set; otherwise the bit is cleared. 


Packet Data Display 
| O Hex (e) ASCII | 


The Packet Data Display buttons allow the user to select the type of display for the packet's data: 
hex strings or mixed ASCII and hex. [Note: This operation may take up to 10 seconds for large 
packets.] If an error occurs during the format conversion, an error message is displayed and the 
conversion will abort. You may enter data in either format at any time. The above buttons are 


used only when the display is updated or when you wish to convert data to the format 
immediately. 
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Preparing a Packet 


When you press the edit button for a particular packet in the main window, the edit window of 
figure 2 will appear and you will be shown the information of that packet. This window is 
divided into two main sections: the header and the data, with 18 editing fields. Only one editing 
field is active at a time. This is indicated by highlighting that field s rectangular box. There are 


several circular buttons, check boxes and command buttons (OK, CANCEL and CLEAR) used 
in preparing the packet. The standard Macintosh editing features apply to most of these controls. 
Some, however, need further clarification. These are: 


o Pressing the TAB key causes Poke to verify the information in the current field 
before activating the next field. The same is true if you press the RETURN key 
(except within the packet's data field). If an error is detected while verifying a 
field, a beep will sound and Poke will return you back to the error's location. 
(Possible errors are described at the end of this section.) 


o Clicking the mouse on a different editing field will verify the information in the 
currently active field. If there are no errors, Poke moves to the field clicked on. 


o You may type data beyond that visible in the field. Leading blanks are 
automatically removed in the packet header fields. 
Entering the Packet's Name 
The packet's name is used only to visually distinguish the various packets from others in the 
main window. It may contain any sequence of printable characters, but it is suggested that you 
limit the number of characters to 16. 


Entering Information in the Header Fields 


Information in the packet header fields can be entered in any one of three ways: 


Decimal : Type in the digits (e.g. 128). This is the default entry type. 

Hexadecimal : All hexadecimal (hex) numbers are preceeded by a dollar sign (e.g., 
$80 = 128). 

Binary: Binary numbers are preceeded by a percent sign (e.g., %1111 = $0F 
= 15). 


Leading zeros are ignored. When a field has been verified, the number entered is automatically 
converted to hex format. 


Possible Error Conditions: 


o Value in field is out of range. (see AppleTalk Protocol documents for the 
permissible ranges of the various fields) 

o Unknown character in field. Valid digits for decimal format are [0..9] (where 
this represents a range from zero to nine); valid digits for hex format is [0..9, 
a..f, A..F], and valid digits for binary numbers are [0,1]. 
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Caveats: 


o Editing of the packet's data field will slow down appreciably as its size increases. 
Whenever possible, display it under the ASCII mode to minimize the number of 
screen characters. 

o While in the ASCII display, all characters in the printable ASCII range ($20-$7E) 
and RETURN ($0D) will be displayed in their ASCII form, even if they were 
entered as hex strings. 

o The packet data field is limited to 55 lines. Even short packets (e.g., entering 
more than 55 carriage returns in the packet's data field in ASCII mode) can go 
out of the scrolling range. 

o Numbers cannot be entered into the packet's data field in decimal or binary 

format. 

In no case can the size of the packet be greater than 603 bytes, including ALAP 
header. 

o If an error occurs while verifying or converting the packet's data field, the 
information at the error location may change, as Poke tries to back out of the 
error gracefully. 

If you have chosen DDP or ATP packet types from the edit window, DDP long 
format will always be displayed, even if the ALAP type of $01 (short format) 
was entered. 

o If you enter more than 600 bytes of packet data, the checksum calculation may not 

work correctly until you have exited and reentered the editing window. (This 
will truncate off all excess data from the end of the packet). 


° 


° 
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The OK button should be pressed when you are through editing the packet. All fields are 
verified for correctness and the packet length is displayed before returning to the main window. 
You will also have the option, at this time, to calculate a checksum for the packet. If any errors 
are detected, you will be returned to the edit window. | 


The CANCEL button terminates the editing session without saving any changes to the packet. 
The packet is returned to the original form that it had prior to this editing attempt. Poke returns 
you to the send window. 


The CLERR button clears all editing fields and inserts the default information into them. 
Sending Packets 


To send packets, Poke must be in the send state (i.e., displaying the main window). Any one of 
the ten packets may be sent by clicking on its active SEND button. The number of times the 


packet will be sent and the delay between each of these transmissions is shown at the top right 
corner of the main window in the short form: 


Rpt Factor = nx : d ticks 


where: n = number of transmissions 
d = time interval between transmissions (in ticks) 


If a SEND button is inactive, you must first edit the packet. The result of the SEND operation 1s 
displayed in the message area at the bottom of the main window. 


possible Error Conditions: 


o No error; packet was sent to destination node (or broadcast) 
o -95; Packet was unable to be sent because either the destination node did not 
respond or the line was sensed "in use" 32 times. 


When Poke starts up, the MPP driver is opened and initialized. If the open call fails and you are 
returned a -35 error, you will be forced to exit the program. Most likely the cause of this error 
will be that the MPP driver is not installed in the System resource file. In addition, if the system 
heap is fragmented such that the MPP driver cannot get enough memory to load, the same error 
will be returned. 


If the serial port configuration byte (SPConfig) is not set correctly, you will get a -98 error when 


Poke starts. See the AppleTalk Manager manual for additional information on location and 
contents of this byte. 
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' é File Edit Tools 










Packet Name: |ATP DDP long Packet Type: OLAP ODDP @AITP 


Header Data 


AA id A Pr a UST UE 


PREIS TAP A 


S ZEITEN 


Hop Count: [so] Dest Skt *: [$8 1 Sre Skt ®: 
DDP Type: Dest Node Addr: Src Node Addr: 
Checksum: Dest Net #: ($1 ] Src Net *: 


ATP T——-——--—---——— TU E es CDM M 
Reg ORsp ORel Trans ID: [$FFE__] K HO []EOM LISTS 
BitMap: Eo] ut: [$t Ju2: [$2] us: ($3 us: [$4 ] 


Packet Data 


This is ASCII data. If I wish t€ enter unprintable characters, | enter 
characters like: $00,$01. 









prr NIE A 






e e 


^p ea tat D 


SEEMS ET AU Pal Fa ee 


Packet Data Display 
OHer @ASCII 





Figure 2. Edit Window (ASCH Display) 
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é File Edit Tools 
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Figure 1. Main Window 
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Hop Count: [$O |] Dest Skt *: [$a  ] Src Skt *: à 
DDP Type: [$5 ] Dest Node Addr: Sre Node Addr: 
Checksum: Dest Net *: [1 — 1] Src Net #: 


Packet Data 


$54$68$69$73$20$69$73$20$4 1$53$43$49$49$20$64$6 187486 1$2E$20$20$49$66$20$49$ 
20$77$69$73$68$20$74$6F$20$65$6E$74$65$72$20$75$6E$70$72$69$6E$74$6 1$62$6C$6 
5$20$63$68$6 1$72$6 1$63$74$65$72$73$20$20$49$20$65$6E$74$65$72$20$53$68$5 1$72 
$6 1$63$74$65$72$73$20$6C$69$68$65$30$20$00$2C$0 1$2C$24$20$58$64$5F $6C$60$6 1$ 
72$20$73$69$67$6E $5D$2E 


e Iv 


NO naa it D REL Iria ID NN 


š Packet Data Display 
|| @Hex OASscil (CANgEL) | CLEAR 
a LYDON SORELLE IS MOVEMENT EE ANDARE, TA IA ARA A eS 


Figure 3. Edit Window (Hex Data Display) 
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ASCII Characters 


FreeTerm allows you to transmit all 128 ASCII characters from the Macintosh keyboard. Typing 


the % (command) key plus an alpha key (A-Z) sends a control character to the host. The following 
keys send special characters to the host: 


Key Character ASCII CODE 

Enter Hardware Break None 

% 2 Null 0 

(% Ato Z) Other Control Characters 1-26 

3 [ Escape 27 

& * Escape 27 

@A FS 28 

æ 0 FS 28 

% ] GS 29 

x 9 GS 29 

€ 6 RS 30 

% - US 31 

(Space to ~) Normal Characters 32-126 

% Backspace Delete 127 
Apple Menu 


— Selecting "About FreeTerm” opens a window to display version information, 
the copyright notice, and other information regarding FreeTerm. To continue, click inside the 
window. 


Desk Accessories — All desk accessories are available to you while you are using FreeTerm. Until 
it is closed, a desk accessory will remain on the desktop - even if it is hidden behind the terminal 
window. You can close each desk accessory individually by using it's close box, or if itis a menu 
desk accessory, selecting Quit from the desk accessory's menu. 


File Menu 


ASCII Capture — The terminal session or a portion of it may be recorded to a MacWrite text-only 
file. When you select ASCII Capture you will be asked for a file to download the terminal session 
to. The default name for the session is "Log File". ASCII Capture can be stopped by selecting 
Stop Capture on the FreeTerm menu. 


ASCILSend — Asks for a text-only file to be sent to the host. The upload supports x-on/x-off 
protocol. Sending may be aborted by selecting Stop Sending option from the Free Term menu or 
hitting any key on the keyboard. 


ive — Selecting this option will start the Xmodem receive file process. You will be 
asked for a file name to download to. The default name is "Rcv File". 


Once the Xmodem protocol starts, Freelerm will display a dialogue showing the current volume 


and file name being transferred, the number of blocks received (1 block = 128 bytes), and the error 
status. 
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Freelerm 


What FreeTerm Does 


FreeTerm is a simple 24 line by 80 character TTY (dumb) terminal emulator. It supports sending 
and receiving ASCII files, copy and paste, and all ASCII characters from the keyboard. 


FreeTerm can also send and receive files using the Xmodem error- correcting protocol (sometimes 
known as the Christensen or Modem? protocol) which is compatible with most telecommuncations 
systems. In addition, Free Term allows you to send and receive Macintosh applications and 
documents using the MacBinary format. 


FreeTerm will work with all types of modems that support asynchronous communications at 300, 
1200, or 2400 baud. If you have a null modem cable, it may also be used to communicate between 
two computers. 


FreeTerm 1.6 


FreeTerm version 1.6 is included in the Tools folder of the 5/85 MacStuff 1 disk. It works 
correctly on a 128K or 512K Macintosh but does not always work on a Macintosh XL running the 
final release of MacWorksXL included in the May Supplement (it does work with the 12/84 
pre-release of MacWorks). A later version of FreeTerm which works correctly on all versions of 
MacWorks will be available via MAUG on Compuserve (described in separarate document). 


Starting FreeTerm 


The FreeTerm application on the desktop shows an icon with a phone handset sending and 
receiving data. This application may be opened throught the Finder's File menu or it may be 
double-clicked. 


Using FreeTerm 


When you first open an unused copy of FreeTerm it will display a dialog asking which port your 
modem is connected to; you may choose the modem port (port A) or the printer port (port B). If 
FreeTerm can identify that a port is in use (e.g. AppleTalk is connected) the name of that port will 
be dimmed and may not be selected (if both port names are dimmed the only option will be Exit 
Program). After completing the initial dialog FreeTerm will open the selected port for 
communication; because FreeTerm can not always tell if a port is in use, the user must be careful 
not to select a port that is being used by another device (e.g. a hard disk). 


After selecting a port, the user may choose Make Default, No Default, or Exit Program. Make 
Default will effect future invocations of FreeTerm, causing the initial dialog to be skipped and the 
selected port to be opened automatically. Both Make Default and No Default will cause the 
terminal window to be displayed. Exit Program exits FreeTerm without opening any port. 


While the FreeTerm terminal window is active, any key typed will be sent to the modem. If you 
open or select a desk accessory window, typing on the keyboard will not affect the terminal. 
However, any text received by from the modem port will be displayed in the window until it is 
closed. 


The FreeTerm window may be resized by selecting the size box in the window. The window 
cannot be sized smaller than 4 lines by 15 characters, or larger than 24 by 80. The terminal always 
remembers the last 24 lines by 80 characters. You may also double-click the title bar to return the 
window to it's full 24 by 80 size. 
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Credits 


FreeTerm was written by William Bond, author of many programs for Dreams of the Phoenix, Inc. 
This documentation was written by Christopher Allen, President of Dreams of the Phoenix, Inc. 


Copies of FreeTerm may be freely distributed (but not sold) as long as the credit notice from the 
"About Free Term..." menu remains intact. 


For more information concerning submitting freelance programs to DOTP, or the Phoenix Block, 
send a self-addressed, stamped envelope to Dreams of the Phoenix, Inc., P.O. Box 10273, 
Jacksonville, Florida 32247, or call (904) 396-6952. | 


FreeTerm is functionally equivalent to desk accessories from Quick & Dirty Utilities Volume One 


published by Dreams of the Phoenix, Inc. DOTP also sells Mouse Exchange BBS and Mouse 
Exchange Terminal — both support the MacBinary format. 
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If the file you are downloading is a MacBinary file, FreeTerm will ıgnore the file name you 
selected. Instead, it will download to the name found in the first block of MacBinary file. 


While FreeTerm is receiving a file, you will not be able to use a desk accessory until the file 
transfer is finished, or until you have cancelled the transfer. 


You may stop the Xmodem Receive process at any time by typing any key. 


Xmodem Send — Selecting this option will start the Xmodem send file process. You will be asked 
to select a file to upload. If the file is an Macintosh application or document, FreeTerm will upload 
the document as a MacBinary file. | 


However, if the file you are uploading is a text-only file, FreeTerm will give you the option of 
sending the document as a Text File. If you choose to send it as Text, FreeTerm will convert the 
file into a standard ASCII file readable by most computer systems. 


While FreeTerm is sending a file, you will. not be able to use any other application or desk 
accessory until the file transfer is finished, or until you have cancelled the transfer. 


You may stop the send file process at any time by typing any key. 


Settings — This menu option allows you to set the configuration of FreeTerm for the system that 
you are connecting to. You may set the speed, data size, parity, duplex, and the port for the 
terminal. In addition, you may select LF after CR , Vax Mode, and the default configuration. 


e Speed can be set for 300, 1200, and 2400 baud (bits per second). 


« The number of data bits (word size) can be 8 (for most BBSs) or 7 (for most 
mainframes). 


* Parity can be none (for most BBSs), even, or odd (there is no support for mark 
and space parity). 


* The duplex mode can be set to be full (for most systems) or half. 


* You may choose to attach your modem to your Modem or Printer port. If 
FreeTerm can identify that a port is in use (e.g. AppleTalk is connected) the name 
of that port will be dimmed and may not be selected; because FreeTerm can not 
always tell if a port is in use, the user must be careful not to select a port that 1s 
being used by another device (e.g. a hard disk). 


* "Prompt for port at startup" will effect future invocations of FreeTerm. 
Choosing it and subsequently pressing Make Default will cause the initial port 
selection dialog to be displayed at startup (like the first time FreeTerm was 
opened); otherwise the initial dialog will be skipped and the selected port will be 
opened automatically. 


* "LF after CR" is for use with systems that do not send, or do not reliably send, a 
line feed after a carriage return (symptom: all text is received on a single line). 


e "Vax Mode" makes the backspace key send the ASCII delete character, and % 
backspace sends a normal backspace. In addition, if FreeTerm receives a delete 
character from the host, it will treat it as an backspace. 


» Make Default will make your current configuration the default for the next time 
you run FreeTerm. Then it will return to the FreeTerm terminal window. 


« OK will return to the FreeTerm terminal window without changing the default 
configuration for the next time you run FreeTerm. 
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When FreeTerm starts up, it will display an information window. To continue, click the mouse or 
hit any key. | 


File Menu 






Text Capture... 
Text Send... 


PTI ELSE a ad 












Hmodem Receive... 
Hmodem Send... 


arorrAro ron TO FI CIT CIT III EEE »nursu»viétE S6 9o AAA anar AAA 


Jona rm AA IFAI IF AAA AAA AA LALA LIFE rr 






Clear Screen 
Quit 


ASCII Capture — The terminal session or a portion of it may be recorded to a Mac Write text-only 
file. When you select ASCII Capture you will be asked for a file to download the terminal session - 
to. The default name for the session is "Log File". ASCI Capture can be stopped by selecting 
Stop Capture on the FreeTerm menu. 


Capture in File: i Telecom 


Log File | 


Cancel 





ASCH Send — Asks for a text-only file to be sent to the host. The upload supports x-on/x-off 
protocol. Sending may be aborted by selecting Stop Sending option from the FreeTerm menu or 
hitting any key on the keyboard. 


Xmodem Receive — Selecting this option will start the Xmodem receive file process. You will be 
asked for a file name to download to. The default name is "Rcv File". 


Receive in File: : Telecom 


Eject 
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FreeTerm version 1.8 Update 


FreeTerm 1.8 replaces FreeTerm 1.6 which was included in the May 1985 Software Supplement 
(along with documentation) . Version 1.8 will work on any Macintosh (Macintosh 128K, 512K, 
Plus, or XL) and is somewhat faster and more reliable than version 1.6. This document briefly 
describes FreeTerm and the features that have changed in the new version. A complete description 
of FreeTerm 1.8 can be found on various electronic bulletin boards on systems such as | 
Compuserve (in MAUG's Data Library 8), Delphi (in the ICONtact area), and GEnie. 


What FreeTerm Does 


FreeTerm is a simple 24 line by 80 character TTY (dumb) terminal emulator. It supports sending 
and receiving ASCII files, copy and paste, and all ASCII characters from the keyboard. 


FreeTerm can also send and receive files using the Xmodem error- correcting protocol (sometimes 
known as the Christensen or Modem? protocol) which is compatible with most telecommunications 
systems. In addition, FreeTerm allows you to send and receive Macintosh applications and 
documents using the MacBinary format. 


FreeTerm will work with all types of modems that support asynchronous communications at 300, 
1200, or 2400 baud. If you have a null modem cable, it may also be used to communicate between 
two computers. 


Starting FreeTerm 


The FreeTerm application on the desktop shows an icon with a phone handset sending and 
receiving data. This application may be opened through the Finder's File menu or it may be 
double-clicked. 


e 
FreeTerm 1.8 


When FreeTerm is opened and a communications port has not been previously defined, FreeTerm 
will prompt for the communications port to be used before opening any port. If a port is already in 
use (i.e. AppleTalk), FreeTerm will attempt to determine this and make that option unavailable. 
Select the port that is connected to the modem or host computer. DO NOT SELECT a port that is 
already in use by another device (such as a hard disk). Selecting the Exit Program button will exit 
FreeTerm without affecting any port. 


Indicate which port your modem is 
connected to. Do not select a port 


that is being used by another device. 


(€ Modem 
Q Printer 


Make Default No Default Exit Program 
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While FreeTerm is sending a file, you will not be able to use any other application or desk 
accessory until the file transfer is finished, or until you have cancelled the transfer. 


You may stop the send file process at any time by typing a command-period. 


Settings — This menu option allows you to set the configuration of FreeTerm for the system that 
you are connecting to. You may set the speed, data bits, parity, duplex, and the port for the 
terminal. In addition, you may select Prompt for port at startup, LF after CR , Backspace to 
Delete, and Fast-Track Receive. These settings can be changed for the current session only, or 
made default for each time you start FreeTerm. 


Speed (@ 300 O L 200 © 2400 
Data bits (98 O? 

Parity @ None O Even O 0dd 
Duplex (e) Full O Half 

Port @ Modem © Printer 

[]Prompt for port at startup 


[]LF after CR 

[]BS -> DEL 

D] Use CRC for Hmodem 
[] Fast-Track Receive 





« Speed can be set for 300, 1200, and 2400 baud (bits per second). 

* The number of data bits (the word size) can be 8 (for most BBSs) or 7 (for most mainframes). 

« Parity can be none (for most BBSs), even, or odd (there is no support for mark and space parity). 
« The duplex mode can be set to be full duplex (for most systems) or half. 

* You may choose to attach your modem to your Serial or Printer port. 

e Rather than selecting a default port to attach your modem to, you can be prompted for the 


communications port each time you startup FreeTerm. 


LF after CR is for use with systems that do not send, or do not reliably send a line feed after a 
carriage return (symptom: all text is received on a single line). 


+ BS -> DEL makes the backspace key send the ASCII Delete character, and 9$ backspace sends a 
normal Backspace. In addition, if FreeTerm receives a delete character from the host, it will treat it 
as an backspace. | 


* Use CRC for Xmodem for most computer systems, or turn it off (checksum mode) for systems 
using older versions of Xmodem. 
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Once the Xmodem protocol starts, FreeTerm will display a dialogue showing the current volume 
and file name being transferred, the number of blocks received (1 block = 128 bytes), and the error 
status. 


Uolume: Telecom 
File: Test 
Status: OK 

Block: 18 of 


Receiving MacBinary file 
Type Command-period to abort transfer 





If the file you are downloading is a MacBinary file, FreeTerm will ignore the file name you 
selected. Instead, it will download to the name found in the first block of MacBinary file. 


While FreeTerm is receiving a file, you will not be able to use a desk accessory until the file 
transfer is finished, or until you have cancelled the transfer. 


You may stop the Xmodem Receive process at any time by typing a command period. 


Xmodem Send — Selecting this option will start the Xmodem send file process. You will be asked 
to select a file to upload. If tbe file is an Macintosh application or document, FreeTerm will upload 
the document as a MacBinary file. | 


to alex.m100 |: | Telecom 
to ArtPro HHE : 


to bill ii i Eject 


to icca 


to regtech 





However, if the file you are uploading is a text-only file, FreeTerm will give you the option of 
sending the document as a Text File. If you choose to send it as Text, FreeTerm will convert the 
file into a standard ASCII file readable by most computer systems. 


Send as Text or MacBinary ? 
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* Fast-Track Receive allows you to speed up Xmodem when receiving files from such networked 
systems as CompuServe, Delphi, and The Source. The speed increase can be as much as 100%. 
However, Fast-Track Receive can only detect transfer errors, not correct them. If you have a 
transfer error while using Fast-Track Receive, you must re-start the file transfer. 


Once you choose your settings, you can select the Make Default button to make your current 
configuration the default for the next time you run FreeTerm. Or use the ÖK button to have these 
settings remain only until you turn you Macintosh off. 


Clear Screen — The Clear Screen menu option will erase the contents of the terminal window, but 
will not send any characters to the modem. 


Quit — The Quit menu option exits to the Macintosh Finder. If you are capturing your session, 
FreeTerm will automatically save your file before returning to the Finder. 


In addition, FreeTerm stores your current settings. Provided you do not turn off your Macintosh, 


when you re-open FreeTerm, you will be set up using the same configuration that you last used. If 
you have turn off your Macintosh, FreeTerm will use the settings that you chose as defaults. 


Xmodem Error Messages 
The only common Xmodem error message not listed m the FreeTerm 1.6 documentation is: 


Fast-Track Receive Failed - A transmission error was detected when using the Fast-Track Receive 
option. Turn off Fast-Track Receive and try again. 


Credits | 


FreeTerm was written by William Bond, author of many programs for Dreams of the Phoenix, Inc. 
This documentation was written by Christopher Allen, President of Dreams of the Phoenix, Inc. 
Fast-Track Receive was conceived by Jonathan Hardis. 


For more information concerning submitting freelance programs to DOTP, send a large 
self-addressed, stamped envelope to Dreams of the Phoenix, Inc., P.O. Box 10273, Jacksonville, 
Florida 32247, or call (904) 396-6952. | 


Dreams of the Phoenix, Inc. sells a number of programs that support the MacBinary format, 
including Q&D Terminal, Xmodem, & Dialer desk accessories (on Quick & Dirty Utilities Volume 
One - $39.59), Mouse Exchange BBS ($39.95), and Mouse Exchange Terminal ($39.95). 


In addition, Dreams of the Phoenix, Inc. can license or customize versions of these programs for 
third-party developers. 
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Since the Macintosh OS was not designed to support concurrent applications, 
Switcher must modify a number of system ROM routines using RAM-based patches. 
Currently, Switcher modifies or replaces 26 different system routines. The most 
important of these is the "GetNextEvent" routine, which is called periodically by 
most law-abiding applications. Besides performing the usual event-handling 
functions, Switcher's GetNextEvent routine checks to see if the user is requesting a 
context switch by polling the mouse position and the keyboard bitmap. If so, it 
suspends the current application and switches control to a new one. 

The Macintosh clipboard provides a flexible facility for transferring data 
between different applications. Since there is often some overhead associated with 
writing to the clipboard, most applications dont put stuff into it every time a cut or 
paste occurs. However, they must make sure the clipboard is valid to cut and paste 
with desk accessories. Thus Switcher has a devious way to request applications to 
convert their clipboard to global format -- it makes them think that they re cutting 
or pasting into a desk accessory. When the user requests a switch with clipboard 
conversion, the Switcher passes a sequence of phony events to the application to. 
make it think it's pasting into a desk accessory, starting with a mouse-down in the 
menu bar area to get it to think it's pulling down the desk menu. This procedure is 
highly heuristic and evolved by inspecting the behavior of dozens of applications 
(see below for a full description). The bottom line is that your application must 
support cutting and pasting with desk accessories to be able to cut and paste with 


other applications under the Switcher. 


How to determine if you're running under Switcher 


Low memory location $282 is called SwitcherGlobals and it may be inspected 
to determine if your application is currently running under Switcher or not. 1f the 
longword stored there is O or -1, you are not running under Switcher, otherwise 
the longword is a pointer to the Switcher globals area (discussed below). 

If you have code running at the interrupt level (like a completion routine), it is 
sometimes necessary to determine if your application is currently the active one. 
This is easily done by inspecting a unique low memory location like ApplZone 
($2AA) when your application is initialized, and then comparing that saved value 
with the current value; if they're the same, you are currently active. Note that your 
can't store the value in your global area as you can't count on AS being right; nor 
can you store it in the application low memory area. One useful technique is to pass 
AS at the end of your I/O parameter block (or VBL queue element) so you can 
address your globals and therefore store it there; of course you can just store it in 
reserved space in your code segment. Another reliable way to tell if you are 
currently active without accessing your global is to compare the theTask handle in 
the Switcher globals area (see below) with the process state block handle in your 
world table entry, accessing via your world table entry (see below again). 
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A Software Developer's Guide to Switcher 
Andy Hertzfeld 9 Apr 85 


Editor's Notes: Inside Switcher, additional information on the internal workings of Switcher, will 
soon be available from MAUG™ (via Compuserve). Switcher 3.0 is a pre-release version and 
may not be licensed or distributed with commercially available products ; a later version will be 
licensable in the near future. 


The Macintosh Application Switcher creates a dynamic new software environment for the 
512K (or larger) Macintosh, allowing multple application programs to reside simultaneously in 
memory and providing a way to switch between them very quickly. The Switcher tries to support 
every Macintosh application, but the interface between a program and its environment is very 
complex, and Switcher necessarily disturbs this delicate balance, so some programs are not 
compatible with it. This document is intended for an audience of Macintosh software developers 
and will provide suggestions and hints that will help your application to get the most out of the 


Switcher environment. 


The most recent version of the Switcher is version 3.0. It can be used with the versions of 
the MacsBug debuggers included with the May Software Supplement. Some earlier versions of 
MacsBug had a bug that made them not work with Switcher, so be sure to use these new versions 
when testing your applications out with Switcher. When you find that your application doesn't 
work properly with Switcher, please try to pinpoint the difficulty as precisely as possible when 
oe the bug; bugs can be reported to Apple or to me on MAUG/Compuserve (my number is 
70167,3430). 


One source of developer confusion is caused by the way the Switcher fudges memory size 
statistics. It turns out you have to allocate a 96K partition for an application to have approximately 
the same amount of memory it has on a 128K Mac. To avoid confusion for the typical user, the 
Switcher adds 32K to the size of a partition before displaying it. Thus partition sizes are 
"normalized" to the well-known 128K Mac; for example, a partition that's displayed as 256K 


actually only has 224K allocated to it. 


The Switcher knows how much memory to allocate to a given program by inspecting the 
"SIZE -1" resource attached to the program file. The Switcher is capable of generating its own 
SIZE blocks using the Configure command, but it would be very nice if new applications could 
come "pre-configured" for their own &nique memory requirements and other properties. The size 
block is 10 bytes long; there is a flags word followed by 2 long integers. The first long integer is 
the recommended size of the partition, followed by the minimum size. The values are 32K less 
than the virtual partition size (i.e. 96K for a 128K partition). Currently, only the high two bits of 
the flags word are defined. Bit 15 means "save screen" and bit 14 means "suspend/resume" events 
(see below). Unassigned bits should be kept 0 for future compatibility. 


While working at Apple, I had the opportunity to watch a number of fairly complicatéd 
Macintosh applications go through their final debugging cycles. The most time-consuming and 
difficult part of this process is what you might call "memory tuning", which is dealing with various 
out-of-memory situations and with memory fragmentation. Typically, an application is tested and 
tuned to run on both 128K and 512K Macintoshes. However, the Switcher environment supports 
variable-sized partitions, so many more memory situations become possible (i.e., a 256K Mac). 
The biggest problem most applications have working smoothly with the Switcher is that they were 
tuned for 128K or 512K, and sometimes are freaked out by something in between, because they 
make decisions like "it's not 128 so it must be 512". Switcher-friendly applications should test 
memory to see how much is available and be able to deal with a wide range of memory sizes. The 
best way to size memory initially is to grow the heapZone out to its maximum size by requesting an 
enormous block, and then execute a "FreeMem” or "MaxMem" call (Lisa Pascal users can 
alternatively use the "MaxApplZone" call). After initialization, the best way to determine if a certain 
amount of memory is currently available is to use the "ReserveMem" call. Switcher also sets up the 
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The Process Control Block 


Every application running under Switcher has a process control block 
associated with it that contains various low memory values, system heap handles and 
other information that comprise the state of the system that must be multiplexed 
between all the currently executing applications. The first entry in the world header 
is a handle to the process control block belonging to that world. 

The process control block consists-of nine different parts. It begins with a 
longword that indicates the current size of the process control block, including 
itself. Next comes tbe saved low memory, at specific offsets (described below) so it 
may be accessed by other programs when an application is suspended. That is 
followed by the saved dispatch table (if MemToSwitch is NIL), or a variable amount 
of additional memory as described by the MemToSwitch table (see below for a 
description of the MemToSwitch data structure). That is followed by information 
necessary to restore any suspend vertical retrace task (a VBL receiver address and 
longword tick count for each suspended element, terminated by a longword of 0). 
Next comes a list of handles in the application heap that must be patched in the 
system heap map. Since resources may be added to the system file while Switcher is 
running, these are identified by a logical address (type and ID), rather than a 
physical offset. Next comes a list of handles that must be patched in the unit table, as 
desk accessories and drivers can live in the application heap and therefore are part 
of the state of the application. After that comes a copy of the application parameter 
handle passed in by the Finder, which is another system heap entity that must be 
multiplexed between the applications. Next comes a descriptor of the state of the 
sound driver and hardware, so that different applications can share the sound 
driver. Finally, there is the address of the stack pointer for the application at the 
time of its suspension. The remaining registers and program counter are saved on 
the stack prior to suspension. 


Defining Switchable Memory 

One of the design goals of Switcher was to include the ability for it to work 
properly in future Macintosh software environments. [ Editor’s note: e.g. the 128K 
ROM in the Macintosh Plus.] Future environments may define memory locations 
that are part of an application's state and therefore must be switched. To solve this 
problem, Switcher inspects a low memory location called MemToSwitch (location 
$286), which contains a pointer to a data structure that may be set up by a future 
software environment. If its value is -] or 0, Switcher assumes that it's operating in 
the normal environment defined by the standard Macintosh ROM. Otherwise, it 
interprets the value as a pointer to a data structure defining additional memory to 
include as part of an application s state. 
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An even more exciting area is that of “interlocking” applications that run fine by themselves 
but are ultra-integrated when run together under the Switcher. Applications can find out the global 
picture by inspecting Switcher globals. Switcher globals are accessed through a low-memory 
pointer kept at address $282. If the pointer kept there is -1 or 0, it means that the application is not 
currently running under the Switcher. Otherwise, its a pointer to a public table of Switcher global 
variables. The first 8 longWords in the table is a list of pointers to the base of all currently active 
applications, or zero if no application is present in a given slot. By inspecting this table, 
applications can determine what other applications they are coexisting with and where they are 
located. Apple will eventually provide complete documentation on effectively using this "world" 
table, as well as detailing some other useful Switcher globals. 


Allin all, it is amazing to me how many programs do run properly under the Switcher. Most 
developers should not have to worry or understand all of the stuff discussed here; ordinary 
applications usually run just fine. Jt has been fun working on the Switcher. To diagnose various 
crashes, I had to trace through the guts of lots of very different applications. Countless features 
and strategy shifts were implemented to support this or that application. As a designer of the Mac 
system, I'm one of the very few who never had the experience of trying to learn how it works. In 
a way, developing the Switcher was the application programmer's revenge for that experience. It 
certainly gave me a new appreciation for our strange and wonderful software base. 
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Note that the entire range of graphics, toolbox and loader globals are saved 
consecutively beginning at offset 64. Thus to access the WindowList of a suspended 
application (which is normally at low memory address $9D6) I would use offset 542 
($9D6-$800+72). To find out the name of a suspended application, which is stored at 
$910, I would use offset 344 ($910-$800+72). 

Note also that the contents of the process control block are valid only when an 
application is currently suspended. If an application is active, look in actual low 
memory for the current values. If an application has never been suspended, the state 
of its process control block is undefined. 


Accessing other HeapZones 


When developing a series of highly integrated applications, it is sometimes 
useful to read and write to a heapzone of another application. It is simple to read 
information from another heapZone -- you can access the low memory of a 
suspended application in the manner described above to pick up a pointer or handle 
to information in the suspended application's heapzone. It is harder, but possible, to 
allocate data in a suspended application's heapzone. To do this, you must save a few 
critical low memory locations on the stack: location $114 (heapEnd) and the twelve 
bytes at location $328 (growZone information). Replace these locations with 
information from the suspended application's process control block, as described 
above. Then perform at SetZone to the address of the application's world base + 18 
(or offset 34 in the process cóntrol block, which should be the same). Now you can 
make various memory manager calls. After you're finished, resave the low 
memory locations back into the process control block, as they might have changed. 
Finally, replace the low memory locations with their original values saved on the 
stack. 

Any application whose heapZone has memory allocated in it while it's 
suspended must take care in it's GrowZone procedure not to access any low memory 
or global variables, as low memory and A5 may not be properly set up at the time 
GrowZone is invoked. If interlocking applications are properly architected, it is 
very rare to have to allocate memory in the heapZones of suspended applications, 
the applications should allocate a spare block of appropriate size before they are 
suspended, and leave a pointer or handle to it in the ApplScratch low memory area, 
thus avoiding the necessity of allocating memory when they are suspended. 


Switcher Globals 


The Switcher maintains a number of global variables to help it perform its 
various functions. It is sometimes helpful for an application to access them. As 
mentioned above, Switcher globals are pointed to by location $282. If the longword 
stored there is 0 or -1, you are not currently running under Switcher; otherwise 
$282. contains a pointer to the Switcher globals. 


Inside Switcher Summer 1985 (First Draft) Page 6 


Inside Switcher 


by Andy Hertzfeld 
Summer 1985 
(First Draft) 


Introduction 


Switcher is a small but powerful utility program (about 16K of tight assembly 
language) that creates a dynamic new software environment for the 512K (or 
larger) Macintosh and Macintosh XL systems [editor's note: and Macintosh Plus as 
well], allowing multiple application programs to reside simultaneously in memory 
and providing an easy way to switch between them very quickly. Unlike the 
Switcher user manual, this document describes Switcher from the inside out, and is 
intended for a rather sophisticated audience of software developers (you know, the 
Inside Mac crowd). It explains how Switcher works and provides hints for 
customizing its behavior, offering techniques that allow your application to get the 
most from the Switcher environment. 

Switcher has been distributed in many different versions as it went through its 
testing stages. The current version of Switcher is 4.4, the first production release. 
If you are having a problem with Switcher, make sure you are running version 4.4 
by reading the version number displayed in the "About Switcher" dialog. 


Theory of Operation 


Switcher performs some of the same functions as the Finder and the loader, 
allowing users to select and launch applications and documents. Instead of using the 
ROM "Launch" routine like the Finder does, Switcher uses a special routine that 
launches an application into a subset of available memory, allowing multiple 
applications to reside simultaneously in memory. An application's current state (all 
memory locations and register values that are specific to an application) is mostly 
concentrated in its heap and stack areas but also includes various low memory 
globals and system heap objects. Switcher must maintain multiple copies of these 
shared low memory and system heap areas and save and restore them during context 
switches. To switch between applications, Switcher saves these special memory 
areas into a process state record associated with the current application, and then 
replaces them with values belonging to a new application. 


[Editor's note: some of the information on Switcher Memory Structures 
described in this docucument is displayed graphically in a table on page 12.] 
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Here is some sample code to illustrate the technique: 


MOVE.L SwitcherData,A3 ;get ptr to world table 

MOVEQ #7,D3 :8 worlds to inspect 
WorldLoop 

MOVE.L (A3)+,D0 «get world pointer 

BEQ.S NextWorld -if slot is empty, skip 

MOVEL (A0),A0 ‚get pcb handle 

MOVEL (A0),A0 ‘handle -> pointer 

PEA 344(A0) | spush ptr to application name 

_DrawString ` «just to do something with it 
NextWorld 

DBRA  D3,WorldLoop ‘loop through 8 worlds 


Switching under program control 
[This section will appear in a future draft] 


Suspend/Resume Events 


Applications can optionally receive suspend/resume events. If an application 
wants to receive them, it should include a SIZE -1resource that has bit 14 set in the 
flags word (see below; offset 0); otherwise this bit should be clear (or the 
application could have no SIZE resource at all; they default off). A suspend event 
means that the next time you call GetNextEvent, you will be suspended. À resume 
event is the first event you get back after you've been re-activated following a 
suspension. Suspend and resume events are both reported as event 15 (formerly an 
application-defined event). The high byte of the message field is set to 01 to indicate 
that its a suspend/resume event (eventually event 15 will be used for other purposes 
as well). The lowest bit of the message field (bit 0) is clear if its a suspend event and 
set if its a resume event. The next bit up (bit 1) is set if clipboard coercion 1S 
required. Additionally, if a program is receiving suspend and resume events, the 
Switcher won't put on the desk accessory charade for clipboard coercion, as it 
assumes that the application is converting the clipboard when requested to in the 
suspend/resume event. 
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The World Table 


As mentioned above, the low memory location known as "SwitcherGlobals" 
(address $282) contains a longword that is a pointer to the Switcher global area (or 
0 or -1 if you're not running under Switcher). That pointer points to a very 
important Switcher data structure called the world table that allows an application to 
determine what other applications it is currently running with and provides access 
to other application's heapZone and low memory areas. 

The world table consists of the first 8 longwords of the switcher global area. 
Each represents an individual switcher slot. If the value of the longword is zero, 
that slot is empty, otherwise it is a pointer to a switcher “world”. 

A switcher "world " is a large continguous chunk of memory that an 
application runs in, that is a non-relocatable block allocated in the Switcher's 
heapZone. It consists of an 18 byte header containing information maintained by 
Switcher, followed by the start of the application heap zone of the world. The 
format of the world header is as follows: 


offset O:handle to the process control block 
offset 4:flags word 
offset 6:address of background process routine (0 if none) 


offset 10: handle to saved screenbits (0 if none) 
offset 14: windowPtr for phony desk accessory (used for clipboard coercion) 


offset 18: start of application heap zone 
| 


The process control block handle is a handle to the data structure that contains 
the current state of a suspended application, which is described in detail in the next 
section. The flags word is used to keep track of some of the properties of the 
application. If bit 15 is set, the screen handle kept at offset 10 (if any) is currently 
valid. If bit 14 is set, the application should be sent suspend and resume events it 
does not need to be subjected to the "desk accessory charade" to convert its 
clipboard. Bit 8 is used to flag if an application is inactive with it's clipboard 
converted: it is set if that's currently the case. Bit 0 is set when an application IS 
running in the partition (even if it's currently suspended). 

The next field in the world header is the background task routine at offset 6 If 
the value stored there is zero, the world has no associated background task; 
otherwise it contains the address of a routine that is called in a round-robin fashion 
with other similar routines when the system is idle (see below). Offset 10 contains 
the handle to a large block of memory containing the saved contents of the current 
screen bitmap, which is zero if no screen is being saved. Bit 15 of the flags word 
must be set or the handle does not currently contain valid data. If an inactive 
application wishes to write something onto its screen, it should set the port's bits to 
the address of this handle dereferenced. The field at offset 14 is used for the 
internal operation of Switcher during clipboard conversion and will not be 
described here. | 

The application heap zone of a given world starts at offset 18 past the world 
pointer. Perform a SetZone to that address to manipulate the heapZone of an 
inactive application (see below). 
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Configuring your application 


Switcher is capable of allocating variable amounts of memory to each 
application. It is very tough for an end user (or even a developer!) to figure out the 
optimum amount of memory for a given program. The Switcher provides a 
mechanism that allows a program to specify its preferred memory configuration, as 
well as some other properties. It discovers this information by inspecting the "SIZE 
-1" resource attached to the program's resource file. The Switcher is capable of 
generating its own SIZE blocks using the Configure command, but it would be very 
nice if new applications could come "pre-configured" for their own unique memory 
requirements and other properties. The SIZE block is 10 bytes long, and its format 
is as follows: 


Offset 0: Flags Word 
Offset 2: preferred memory size 
Offset 6: minimum memory size 


There is a flags word followed by 2 long integers. The first long integer is the 
preferred size of the partition, followed by the minimum size. The values are 32K 
less than the virtual partition size (i.e. 96K for a 128K partition). Currently, only 
the high two bits of the flags word are defined. Bit 15 means "save screen" and bit 
14 means "suspend/resume" events. (see above). Unassigned bits should be kept 0 
for future compatibility. If there is no size resource attached to an application, the 
default configuration of « screen size on, suspend/resume off, 128K prefered and 
128K minimum > is used. | 


Configuring Switcher 


There are a number of ways that Switcher itself can be configured by changing 
some of its resources. Of course all text used by Switcher is kept in resources, so it 
may be translated into foreign languages with having access to its source code. 

The resource ESCK 256 is a 6 byte resource that contains the key-codes and 
ASCII for the keys that control switching. The default value of ESCK 256 is 
"001E212A5D5B" (in hex). The bytes are interpreted as follows: 


Offset 0: ignored; should be 0 

Offset 1: the keycode for "switch right 
Offset 2: the keycode for "switch left" 
Offset 3: the keycode for "switch back" 
Offset 4: the ASCII for "switch right" 


Offset 5: the ASCII for "switch back" 
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The data structure is quite simple. It consists of pairs of words, the first 
defining the address of a block of sequential memory, while the second word 
contains the length (in bytes) of the block. An address of 0 must follow the last pair 
to terminate the data structure. The address is kept to a word since most switchable 
areas are in low memory and it therefore saves space, but a provision is made for 
longword addresses. If the high bit of the address is set (i.e., the address is greater 
or equal to $8000), it considers it to be the high word of a longword that is the one's 
complement (i.e., NOT.L) of the desired address. The size is still kept as a word 
value. 

Since there might be multiple software environments running simultaneously, 
the cautious programmer will not simply store a pointer in the MemToSwitch 
location but rather will inspect it to see if the data structure already exists (1.€., 
MemToSwitch is not -1 or 0). If it already exists, you should copy the information 
there into your own block so enviroments may be nested. 

Since new operating environments are likely to change the location and size of 
the line 1010 dispatching tables (currently 1K long at location $400) Switcher 
assumes the location of the dispatching tables will be included in the MemToSwitch 
data structure, even if it hasn't changed from the nominal locations. 

Normal applications do not have to worry about the MemToSwitch data 
structure; it is only for system programmers that are creating new environments 
that wish to work with Switcher. 


Accessing the low memory of inactive applications 


It is sometimes useful for one application to be able to access the low memory 
of another suspended application. This may be done by examining fixed offsets in 
the process control block. 

The following table describes which offsets in the process control block 
correspond to which low memory values: 


Offset 4: MonkeyLives ($100) 

Offset 6: MemTop ($108) 

Offset 10: BufPtr ($10C) 

Offset 14: StkLowPt ($110) 

Offset 18: HeapEnd ($114) 

Offset 22: theZone ($118) 

Offset 26: ApplLimit ($130) 

Offset 30: SEvtEnable ($15C..$15F) (4 bytes long) 
Offset 34: AppiZone ($2AA) 

Offset 38: MinStack ($31E..$33F) (34 bytes long ) 
Offset 72: GrafBegin ($800..5AFB) (764 bytes long) 
Offset 836: DefVCBPıir ($352) (4 bytes long) 
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The first 32 bytes of the Switcher global area are taken up by the world table, 
as described above. At offset 32 of the Switcher globals is a handle called 
"HostTask", which contains the process control block handle for the Switcher itself. 
Offset 36 is called "TheTask" and contains the process control block handle for the 
currently active task. If HostTask equals theTask, the Switcher is the currently 
active application. The name of the current application made be determined by 
inspecting offset 344 (see above) into the process control block specified by 
theTask. Next, at offset 40, is the flags word describing the properties of the 
currently active application. 

The next 8 bytes are scratch locations used for parameter passing. Next, at 
offset 50, is a boolean called ArrowEnable. This allows an application or desk 
accessory to turn off the Switcher arrow that appears in the menu bar area, so it may 
use that space for other purposes. If the byte stored at ArrowEnable is O, the 
Switcher arrows will not be displayed and no mouse hit-testing will be performed 
for them. Anyone who changes the state of the ArrowEnable boolean is also 
responsible for updating the menu bar graphics to reflect the change. This means 
calling "DrawMenuBar" for the active application, and invalidating the saved 
display by resetting bit 15 of the flags world in the world table (see above) for any 
inactive application. 

The next byte, at offset 51, is called ClipConvert and is a boolean maintained 
by the Switcher application that contains the state of the "Always Convert 
Clipboard" flag. The next word, at offset 52, is called Hibernation. It's normal 
state is 0: it is non-zero only when the Switcher is exited with one remaining 
application. That application is switched to and the Switcher goes into "hibernation" 
by setting that boolean. 

Next, at offset 54, is a longword called MainZone, that contains a pointer to the 
Switcher's heapZone, which is the meta-zone that all the other partitions are 
allocated in. The next 6 longwords, beginning at offset 58, is an address table 
holding the addresses of selected Switcher core routines so they can be accessed by 
an application or desk accessory. See the section below on "Switching under 
program control" for a description of these routines. 

Only two other globals are of interest. Offset 90 is called NextTask and it 
contains an integer which specifies which world is next one to be switched into. 
Finally, offset 96 contains the string that represents the name of the Switcher 
application. An application may transfer control back to the Switcher by calling © 
OpenDeskAcc with that name as the parameter. 


Finding out which other applications are running 


Using the information described above, it should be easy to find out the names 
of all the programs we're running with. Using the switcher globals pointer (at 
$282) to gain access to the world table, you inspect the 8 longword pointers in the 
world table. The first field in the world data structure is the process control block 
handle. At offset 344 into there is a string containing the name of the application. 
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Switcher's Limitations 


Although Apple has tested Switcher and is satisfied with its performance and reliability, 
Apple cannot guarantee the reliability of any particular application or combination of 
applications used with Switcher. Apple makes no warranty with respect to the quality, 
performance, or fitness for a particular purpose of Switcher or any software being used with 
it. Asaresult, the Switcher is sold "as is” and you, the purchaser, are assuming the entire 
risk as to its quality and performance. The manual gives you information for maximizing the 
reliability of applications by identifying potential problem areas and suggesting safe 
configurations. 


How to Use Switcher 


You'll find working with your usual applications under Switcher is easy. This section tells 
you how to use Switcher, how to use an application running under Switcher, and how to 
create a Switcher document--your own custom set of applications. 


Configuring Your Disks 


Assuming you have two disk drives available, here is the recommended way to configure 
your disks. You should only have system files on one disk. Remember that some 
applications (including MacDraw and Mac Write) require the printing resource (a file in the 
System folder with the same name as the printer such as Imagewriter or LaserWriter) to be 
on the same disk as the application. 


Startup Disk (Internal Drive) Application Disk (External drive) 
System Folder & files Applications 
Switcher Documents 
Switcher Documents Switcher Documents 
Applications (if room) No system files (except a printing 
Documents (if room) resource if necessary) 
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Background Processing 


There are many time consuming tasks we often perform that don't require the 
full attention of the Macintosh or ourselves; we'd like to be able to do some other 
useful work while they execute "in the background". Some common examples are 
file downloading and printing. Switcher supports a mechanism by which 
applications can arrange to get called even when they are currently suspended, 
thereby allowing them to execute in the background. 

Offset 6 in the world table for each application is the address of a routine that 
Switcher will call every once in a while when it sees a null event come through. The 
Switcher goes through all currently installed background task handlers in a round 
robin fashion, call one each null event. An application can access its world table 
entry by taking the pointer at ApplZone ($2AA) and subtracting 18 (see above). It 
installs a background routine by storing a non-zero value at offset 6 in the world 
table entry; it removes a background routine by storing zero there. 

At the time a background task is invoked, its world table entry pointer is 
passed to itin Al. From there is can pick up the process control block and access its 
saved low memory if neccessary. In particular, it can pick up its current AS value at 
offset 332 in the PCB so it can access its globals as necessary. If it is necessary to 
allocate information in the heapZone, it can employ the techniques described in 
"accessing other heapzones" (described above); this should be avoided if possible 
and often can be, by pre-allocating memory before the application is suspended. 

If installed, the background routine of an application will be called even when 
the application that owns it is currently active. Sometimes this is desirable while in 
other circumstances it is not. It can be avoided by installing the background task in 
the world table when you get a suspend event, and zeroing it upon receiving a 
resume event. Another technique is to always leave it installed, but check the Task 
(accessed via SwitcherData) with the world table entry (accessed via Al) and doing 
no work if they match. 


Vertical Retrace Tasks and Asynchronous I/O 
[This section will appear in a future draft] 
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Using Applications With Switcher 


Once you have installed and started the applications you want to use, you're ready to take full 
advantage of Switcher. With Switcher you can work within any one of your applications as 
you normally would, then switch to another almost instantly. 


Switching To Other Applications 
When you click either side of the arrow, Switcher moves you to the next or previous 


application, depending upon whether you click the right or left arrow. You can begin 
working immediately with the application. 





You can also use a keyboard shortcut to switch: Typing Command-[ switches you to the 
right. Typing Command-] switches you to the left. 


Returning to the Switcher Screen 


There are several ways you can return to the Switcher screen from an application. Use the 
technique you like best. 


1. Click the center of the switching arrow. You return immediately to the Switcher screen. 
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The resource CFIG 0 is an 8 bytes resource that contains the state of the 
Switcher options, as set by the options dialog. The default value of CFIG 0 is "0000 
0000 FFFF 0000" (in hex) The format of the 8 configuration bytes is interpreted as 


follows: 


Offset 0: 
Offset 1: 
Offset 2: 
Offset 3: 
Offset 4: 
Offset 5: 
Offset 6: 
Offset 7: 


ignored; should be 0 
Disable Keyboard Switching 
Reverse Switch Directions 
Same One Twice 

Back After Launch 
Switching Animation 
Always Convert Clipboard 
Switcher in Rotation 


When the Switcher is launched, it scans the volume it is on for a Switcher 
document ofa certain title. If one is found, that document is automatically opened. 
The name it uses for the start-up document is kept in the resource STR 40. It 
current defaults to "Switcher.StartUp". 


Being Switcher Friendly 
[This section will appear in a future draft] 


Converting the ClipBoard 
[This section will appear in a future draft] 


Re-entrant Applications (Same One Twice) 
[This section will appear in a future draft] 


Switcher Document Format 
[This section will appear in a future draft] 


Inside Switcher 
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Creating a Switcher Document 


Switcher provides you with a fast way to load your favorite combination of applications, 
settings, and options. The state of Switcher: its options and active applications at a given 
moment in time, is called a set. You can recreate a set at any time by saving information 
about the set as a Switcher document. A Switcher document contains information to 
start Switcher and load all the applications and options that comprise the set. 


To create a Switcher document, start Switcher and install all the applications you want to use. 
If you want the set to open with a particular document, use the Attach Document command. 
(See below.) Select any Switcher option changes you want (Switcher menu). When you re 
satisfied with the configuration, choose Save Set from the File menu. You'll be asked to 
name the set. 


Starting Switcher From a Switcher Document 

To start Switcher with a set of predetermined applications, just open a Switcher document 
from the Finder or, from within Switcher, and choose Load Set from the Switcher's File 
menu. 

After you've saved a set or loaded a new set, any changes you make to the set such as adding 


or removing applications or documents doesn't affect the contents of the saved set in the 
Switcher document. 


Quitting Switcher 


In order quit Switcher, you must first switch to each application, save, and quit. Then return 
to the Switcher screen and choose Quit from the File menu, or click the close box in the 
Application Switcher window. If you want to start another application, simply quit one 
application then start another from the Switcher screen. 


You'll be allowed to quit Switcher if just one application is still installed. If you haven't 
saved, you'll be asked to save any changes from the last application. 


It is important to quit each applicanon individually. Never just switch the Macintosh off. 
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Switcher (Beta Draft) 


June 4, 1985 


About This Document 


This is the Beta draft of the documentation aimed at not-so-naive users. This draft 
corresponds with Switcher version 3.0. 


About Switcher 


Switcher is a unique environment for the Apple Macintosh™ computer that allows you to use 
two or more applications at once. Switcher and the power of Macintosh 512 provide you 
with an environment where you create your own custom "integrated" applications and switch 
between them instantly. Switcher divides available memory; you allocate portions of it to 
different applications. You can work on a diagram in MacDraw, switch instantly to 
MacWrite when you get an inspiration for your report, then switch back to MacDraw and 
continue with your sketch. And you never need return to the Finder. In fact, you can even 
have the best of both worlds. With the Finder as one of your applications, you can do all 
your housekeeping (copying and removing documents) without ever leaving Switcher or 
quitting an application. 


Switcher is powerful, flexible, and a great timesaver. You'll only need to set up a particular 
combination of applications once. After you've installed the applications you want and 
changed any options, you can save that information in a Switcher document. Opening a 
Switcher document from the Finder tells Switcher to automatically start those applications. 
What could be faster and easier? 


About This Manual 


This manual gives you the information you need to use Switcher to create an infinite number 
of combinations of your favorite applications. 


Hardware Requirements 


Switcher was designed for the Macintosh 512K. An external disk drive is strongly 
recommended to hold additional applications and documents. Switcher also works well with 
the Macintosh XL and third-party hard disks. 


Software Requirements 


Switcher works with all Apple Macintosh software; MacWrite, MacPaint, MacDraw, 
MacProject, MacTerminal, Macintosh Pascal and most third-party software designed for 
Macintosh 128K. Some software designed exclusively for the Macintosh 512K may not 
work with Switcher. Contact specific third-party publishers or ask your dealer to let you try 
out any software you intend to use with Switcher before you buy. 
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Switcher in Rotation. The Switcher screen itself is included in your set of applications. 
As you click the switching arrow, one of the applications you switch to is the Switcher 
screen. 


Always Convert Clipboard. When you are using Switcher, each application maintains its 
own private clip . ]f you copy a piece of text in MacWrite and then switch to MacDraw, 
the text you copied won't appear in MacDraw's clipboard. Choosing Always Convert 
Clipboard tells Switcher to always transfer the Clipboard from the current application to the 
next application. When this option is in effect, you'll notice it takes longer to switch between 
applications. 


You can override the current state of Always Convert Clipboard by holding down the Option 
key as you switch to the next application. For example, if Always Convert Clipboard is 
unchecked, then switching while holding down the Option key will convert the Clipboard 
contents for that particular switch. If Always Convert Clipboard is checked, then switching 
while holding down the Option key will not convert the Clipboard contents for that particular 
switch. We recommend you not check Always Convert Clipboard and use the Option key 
only when you need to copy the Clipboard to the next application. 


Switching Animation When this box is checked, animation is in effect; applications 
appear to "roll by" on the screen. If this box is unchecked, animation is not in effect; the 
next application simply appears. Although this is strictly a matter of personal preference, 
using animation does take a little more time. 


Back After Launch When this option is checked, you return to the Switcher screen afier 
you install and start a new application. When it's not checked, you remain in the application 
you installed. 


Same One Twice If this option is checked, you'll be able to run the same application 
more than once. If it is not checked, Switcher will only allow you to start the application 
once. Note that some applications create special temporary files or may not be designed to 
handle events "happening behind their backs." Therefore it may not be safe to run multiple 
copies of most applications. Use this option at your own risk. 


Reverse Switch Direction This is purely an aesthetic feature. When you click the right 
arrow, which application do you want to switch to? The one to the "right" or to the "left"? 
You decide the direction you want. 


Room for LaserWriter An application can't print correctly on the LaserWriter with less 
than 144K of allocated memory. This option changes the preferred memory size to 144K or 
adds 16K if the preferred memory size is greater than 128K. If your LaserWriter output 
contains gibberish (a LaserWriter symptom of not enough memory), check to see if this 
option is turned on. | 


When this option is checked, Configure Then Install presents 144K as the preferred memory 
size. Room for LaserWriter only takes effect at the time the apphcation is started; it has no 
effect on active applications. You'll need to quit any active applications and reinstall them ın 
order to increase the memory allocation. 


Note: this feature will not appear in the released version of Switcher. 


Switcher (Beta Draft) Page 8 


Starting Switcher 


Start Switcher like any other application by double-clicking the Switcher icon or choosing 
Open from the File menu. You'll see the Switcher screen: 
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Installing Applications 


The first thing to do after you start Switcher is to install the applications you want to use. 
You can install all the applications you want to use at the outset, or install one, start working, 
and add or remove others later. 


Select a Switcher slot by double-clicking anywhere in it. A dialog box presents all 
applications on the Switcher startup disk. Select the application you wish to install and click 
Open, or click the Drive or Eject buttons to get applications on another disk. Switcher 
installs the selected application, starts it, and returns you to the Switcher screen. You can 
now repeat the process to install another application. 
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Permaner. . The Permanent button installs the application in a slot and makes the 
Configure Then Install options apply to all future Switcher sessions for that particular 
application. You can install the application by double-clicking a slot and the options will be 
in effect every time you install that application. If you wish to change the configuration later, 
quit the application and choose Configure Then Install again. 


Temporary. Clicking the Temporary button installs the application and makes the changes 
for this session only. The Permanent settings remain unchanged. 


Cancel. Returns you to the Switcher screen without installing the application. 


After you've finished configuring an application by clicking the Permanent or Temporary 
buttons, you return to the Switcher screen. The application appears in a slot with the word 
"Configure" to show that the application has not yet been started. To start the application, 
double-click its slot. The application is started. If Back After Launch is in effect, you'll 
return to the Switcher screen. Once you've started an application, you cannot change its 


memory allocation. You must quit the application and choose Configure Then Install again. 


Removing a Nonactive Application 
A nonactive application is an application that has been installed in a Switcher slot using the 


Configure Then Install command, but has not yet been started. The word "Configure" 
appears in its Switcher slot. 


MacWrite 
(SwitcherHints) 


ÉS MacDraw (configure) 









Remove a nonactive application by returning to the Switcher screen, selecting the application 
you wish to remove by clicking in its slot, and choosing Remove Application from the File 
menu. You cannot remove an active application in this manner. After you remove an 
application, its Switcher slot becomes free. 


Speed, Memory, and Safety 


Most of Switcher's features have tradeoffs between speed, memory consumption, or safety. 
While these tradeoffs are listed with each option, this section gives you ideas on how to 
optimize Switcher for one of these factors. Speed refers to the amount of time it takes to 
switch between applications. Memory refers to options that consume memory. Because 
Switcher cannot predict how a particular application is designed, some options may be more 
likely to cause problems. Therefore, safety refers to the safest configuration for most 
applications. 
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` 


2. Choose Switcher from the Apple menu. Whenever you're in an application, you'll notice 
a new command at the bottom, Switcher. Choose Switcher and you'll return to the 
Switcher screen. ` 
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Switcher 3.0 


3. Type Command-\. Hold down the Command key (icon) and the back slash key (located 
directly below the Backspace key). 


Transfering Information Between Applications 


In Switcher's preset state, you won't be able to copy information into one application's 
clipboard and then paste that information into another application. To copy information 
between applications, you can use the Scrapbook or you can tell Switcher to convert the 
Clipboard. Hold down the Option key as you click the switching arrow to convert the 
Clipboard. 


You can have Switcher automatically convert the Clipboard with every switch. See page XX. 


Quitting Applications 


You quit an application in Switcher as you normally would; save your changes and choose 
Quit from the File menu. Depending upon what options are in effect, you return to the 
Switcher screen or to a neighboring application in the set. After you quit an application, that 
application is removed from the Switcher environment and its Switcher slot becomes free. 
To quit the Finder, see "Using the Finder With Switcher." 


Installing Additional Applications 


Return to the Switcher screen and repeat the steps for installing an application. Depending 
on how much memory is available, you can install up to three applications with 128K 
memory each, using Switcher's preset options. To install more than three requires some 
memory conservation tricks and probably a hard disk to hold all the applications you'll want 
to have available. 
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The Switcher Menu 
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Options... 


Install Application, Remove Application, Configure Then Install, and Open all operate on the 
selected slot. 

Install Application Allows you to select an application for installation in a Switcher slot. 
It's the same as double-clicking one of the slots in the Application Switcher window. If you 
haven't selected a slot, Switcher selects the next available slot. 

Remove Application Lets you remove a selected nonactive application from the current 
set. A nonactive application has the word "Configure" in its Switcher slot. An active 
application is removed by switching to it and choosing Quit from the File menu. 

Configure Then Install Allows you to select an application to install and presents the 
Configure window. If you haven't selected a slot, Switcher selects the next available slot. 
See "Configuring Applications.” 

Open Starts a selected nonactive application or switches you to the selected application. 
Switch Left The same as clicking the switching arrow that points left. 

Switch Right The same as clicking the switching arrow that points right 


Options Presents the Options window. See page X. 


Switcher Cookbook 
This section gives information on specific Switcher situations. 


Using Four 128K Applications at Once 


You can have four 128K applications running at a time with Switcher. To do so, you'll need 
to turn off all Switcher options that use memory. In the Options window, turn off Switcher 
in Rotation, Always Convert Clipboard, and Room for LaserWriter. Then install each 
application using Configure Then Install. Change Preferred and Minimum memory size to 
128K or less and uncheck Save Screen. Use the Info Window to monitor your memory 
usage as you configure. 
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Customizing Switcher 


Switcher's preset options are designed so that you'll probably never need to change them. 
But Switcher was designed to be flexible, allowing you to control the settings, options, and 
aesthetics of the Switcher environment. 


Memory Allocation 


Switcher automatically allocates 128K of memory for most applications, or more, if specific 
Switcher options are in effect. Future applications containing a SizeRsc variable will be able 
to request specific amounts of memory from Switcher. However, you may be able to 
allocate more or less memory than an application normally requires. If you are working with 
memory based applications such as MacDraw document, you may want to allocate more 
memory to MacDraw so you can work with larger documents. Switcher not only allows you 
to specify the memory configuration of each application but also provides you with graphic 
information to help you decide on the optimal memory configuration for each application. 
The Configure Then Install command from the Switcher menu lets you determine the amount 
of memory you allocate to an application. 


Memory can only be allocated before an application is installed. Many applications may not 
run or may have problems if any amount other than 128K is assigned. For instance, an 
application may assume that if more than 128K is available, it must therefore be on a 512K 
machine and demands all 512K of memory. It is also difficult to determine how little 
memory an application needs to operate. (We know the Finder will work with 95K, but no 
Jess.) The safest course is to assign 128K. If you wish to assign a different amount, please 
experiment with nonessential information first! 


Switcher Options 


You can tailor Switcher to suit your particular needs and preferences. From the Switcher 
screen, choose Options from the Switcher menu. 


[2] Application Switcher Options 
> 


O Switcher in Rotation 

O Always Convert Clipboard 
[X] Switching Animation 

NX Back after Launch 

[J Same One Twice 

O] Reverse Switch Direction 


O Room For LaserWriter 





You can check or uncheck various options to suit your needs. 
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Emergency Exit 


If one of your applications should "hang" or "crash" (you receive a dialog box with a bomb 
icon), don't click restart or turn your Macintosh off and back on. You may be able to 
recover by exiting the application and returning to the Switcher screen without affecting any 
other applications in Switcher. If you encounter such a situation, try holding down the 
Option, Command, Shift, and period (.) keys. Depending on the type of problem the 


application encountered, you could return to the Switcher screen, without affecting the other 
applications. 


Extras 


Switcher gives you control of the power of Macintosh 512 by providing an environment 
where you create your own "integrated" applications. Switcher lets you instantly switch 
between different applications by dividing available memory. You determine your own 
optimum configurations by deciding which combinations of applications and options you 
need. And with the Finder as one of your applications, you can do all your housekeeping 
(copying and removing documents) without leaving Switcher. 


You need to set up any particular combination of applications only once. After you ve 
loaded the applications you want and changed any options, you can save that information in a 
Switcher document. Opening a Switcher document automatically starts all the applications 
you've designated. 


Returning to the Switcher screen: From within an application, look at the Apple menu; 
you'll notice a new command at the bottom, Switcher. Choose Switcher and you'll return to 
the Switcher screen. 
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Switcher 3.0 





Installing additional applications: Return to the Switcher screen and repeat the steps for 
adding an application. Depending on how much memory is available, you can Install up to 
three applications with 128K memory each, using Switcher's preset options. To install more 
than three requires some memory conservation tricks and probably a hard disk to hold all the 
applications you'll want to have available. 
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Configuring Applications 


The Configure Then Install command (Switcher menu) allows you to allocate a different 
amount of memory to the application you're installing and gives several other options. 


as 1! MacDraw Configuration 
m 


Preferred Memory Size 


Minimum Memory Size 


C] Save Screen 





Preferred Memory Size. The amount of memory Switcher first attempts to allocate to the 

application. 128K, a previously configured amount, or the amount an application requests 1s 

displayed as the preset memory size. If you've chosen Room for LaserWriter, 16K is added 
to the amount. 


Minimum Memory Size. The smallest amount of memory Switcher attempts to allocate to 
an application. Usually, 128K or a previously configured amount is displayed as the preset 
memory size. For example, if you've configured MacPaint with a preferred memory size of 
128K and a minimum memory size of 80K, Switcher looks at the minimum memory size and 
compares it to available memory. If the available memory is 100K, Switcher will allocate 
100K to MacPaint. If the available memory is less than 80K, Switcher will inform you there 
is not enough memory to start MacPaint. Switcher will not allow you to allocate less than 
64K. 


Save Screen. This option keeps the screen contents in memory as you switch from this 
application to another, allowing you to see this application's screen almost instantly when 
you switch to it again. Unchecking Save Screen turns this option off: Switcher must look 
for a "memory map" of the application's screen and recreate it on the screen. When Switcher 
saves the contents of the screen, you'll notice switching between applications seems faster. 
When Save Screen is turned off, you'll notice the screen is redrawn each time you switch to 
the application. 

Save Screen consumes 22K of memory per application. If you choose not to save screens, 
you'll free up additional memory. However, your switching time will increase and some 
applications will not be able to redraw the screen accurately. 


This option does not save your work each time you switch. You'll need to save from within 
each application. 
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Speedy Options 


To switch quickly between applications, choose Options from the Switcher menu. Turn off 
(uncheck) Always Convert Clipboard and Switching Animation. Also, turn Save Screen on 
for each application. 


To start Switcher quickly, save your favorite configurations as Switcher documents. From 
the Finder, simply open a Switcher document. See "Saving Your Configuration." 


You can also designate Switcher as the startup application. This means when you turn on 
your Macintosh and insert the Switcher disk, Switcher is started automatically. To set 
Switcher as the startup application, go to the Finder, select the Switcher application icon, and 
choose Set Startup from the Special menu. When Switcher is the startup application, you 
can designate a startup Switcher document by naming the document "Switcher.startup”. 
Switcher will startup automatically and load the set from the document. 


Saving Memory 


One way to conserve memory is to allocate as little memory as possible to an application. 
Another way is to not use memory-consuming options. Always Convert Clipboard, Room 
for LaserWriter, and Save Screen consume memory when they are in use. Save Screen uses 
22K per application. You can turn save screen off with the Configure Then Install command 
(see page XX) or after an application is installed, with the Application Switcher window 
itself: 


Application Switcher 


Macwrite 


A MacDraw 





Save Screen 
L= 


2 j 
SS MacPaint 
128K 


By clicking the screen of the Macintosh icon in an application's slot, you can turn Save 
Screen on or off. In the example above, the MacDraw and MacPaint screens are saved 
between switches, but the MacWrite screen is not saved (indicated by the "No!" symbol). 


Caution: Once you turn Save Screen off, you may not always have enough memory to turn 


it back on, depending on what you've done in the interim. Switcher will beep if you attempt 
to turn Save Screen on and you don't have enough memory. 
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Using Less Than 128K of Memory 


Some applications (including MacPaint and Mac Write) can run with less than 128K memory. 
Try different memory allocations with the Configure Then Install command. Most 
applications will tell you immediately if they won't work. 


The document size of many applications is limited by the amount of memory available. If 
you create a document using 128K memory or more, you may not be able to open that 
document under Switcher if you've allocated less memory to an application. 


Using 512K Applications 


Applications designed to work on a 512K Macintosh may be able to work with Switcher 
with less than 512K memory allocated. Install the application with Configure Then Install 
using different amounts of memory. The application should tell you if it will run or not. 


Using Switcher With a Hard Disk 


Switcher works well on a hard disk. Just copy Switcher to the hard disk. Be sure to start 
Switcher from the hard disk. 


Using Switcher With AppleTalk ` 


Switcher works well with AppleTalk, although specific applications that use the network 
may not function properly. If you're using LaserWriter over an AppleTalk network, be sure 
to check the Room for LaserWriter option before you install applications. 


The Finder as One of Your Applications 


Having the Finder as one of your set of applications gives you the speed and flexibility of 
Switcher as well as all the utilities of the Finder, with no lost time returning to the Finder. 
Then Finder should be installed in the first Switcher slot. Simply start the Finder in Switcher 
as you would any other application. If you use Configure Then Install, you can change the 
Finder's preferred memory size to as small as 96K for Macintosh 512K (you'll need 102K in 
order to open a maximum of eight windows at once) and 128K for Macintosh XL. 


To quit the Finder from within Switcher, switch to the Finder and start another application. 
To quit Switcher when the Finder is one of the applications, quit any other active 
applications, then quit Switcher. Another way to quit is to use the Finder's Shut Down 
command. Shut Down ejects any disks and then restarts the Macintosh. On a Macintosh 
XL, choosing Shut Down turns the power off, but not on again. This is not recommended 
unless you first save or quit all other applications. 


Don't start a Switcher document from the Finder. 
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Copyright 


Questo manuale Apple ed il software ivi descritto sono oggetti di copyright. Tutti i 
relativi diritti sono riservati. Ne segue che il manuale ed il software relativo non 
possono essere riprodotti o copiati, in tutto, o Comunque utilizzati senza autorizzazione 
scritta di Apple. E' esclusa dal divieto la normale utilizzazione del software e la 
predisposizione di una eventuale copia di riserva, ferma restando la proibizione della 
predisposizione per qualsiasi titolo, anche gratuito, di copie per uso di terzi. E' tuttavia 
consentita la cessione o la messa a disposizione di terzi, anche in comodato, di tutto il 
materiale acquistato, ivi inclusa la eventuale copia di riserva. Nel divieto di copiare ë 
incluso il divieto di tradurre in altre lingue o forme. 

Il software in oggetto potrà essere utilizzato su ogni computer di proprietà del cliente, 
senza che per altro sia consentita, per tale scopo, la produzione di copie. Per alcuni 
prodotti ë prevista la possibilità che il cliente ottenga licenza per l'impiego multiplo del 
software su piü di un computer di sua proprietà come impiego di un sistema a dischi 
condivisi. (ll cliente è invitato a prendere contatto al riguardo con il Distributore 


Autorizzato Apple per maggiori informazioni). 


@ 1985 Apple Computer Inc. 
20525 Manani Avenue 
CUPERTINO, California 95014 
(408) 996.1010 


Macintosh M ë un marchio registrato oggetto di licenza ad Apple Computer Inc., 


le 
, 1 o APPS il o Macintosh, il FinderTM, MacWrite MacPaint! M, 
MacDraw!M, MacProject™, Font/Desk Accessory Mover™ e Switcher™ sono marchi 
registrati di Apple Computer, Inc 


Microsoft®, Microsoft WordTM e Microsoft ChartTM sono marchi registrati oggetto di 
licenza della Microsoft. 


Il programma Switcher è stato scritto da Andy Hertzfeld. 
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Cosa fa 
Switcher 


Switcher fornisce un particolare ambiente di lavoro con il quale potete creare le vostre 
applicazioni "integrate" per il computer Macintosh. Switcher suddivide la memoria 
disponibile e la distribuisce in partizioni alle applicazioni che desiderate utilizzare; potete 
Cosi avviare due o più applicazioni e passare dall'una all'altra istantaneamente. 

Potete per esempio eseguire un bozzetto con MacPaint, passare immediatamente a 
MacWrite non appena avete l'ispirazione giusta per il vostro romanzo, controllare 
l'ortografia e lo stile di scrittura del testo che avete inserito usando un'altra applicazione 
E po ritornare a MacPaint per continuare il disegno - tutto questo senza tornare al 

inder. 

Ma potete fare anche di meglio: mentre Finder lavora con Switcher, ë possibile eseguire 
tutto il lavoro di nordino dei documenti su disco (copiare, cambiare nome o rimuoverli) 
senza mai dover lasciare Switcher o uscire da un'applicazione. 


Switcher ë potente, flessibile e fa risparmiare tempo. Per usarlo potete impostare una 

articolare combinazione di applicazioni che vi interessano; installarle e salvare le 
informazioni sulla loro configurazione in un documento di Switcher. Da quel momento 
tutte le volte che vorrete usare le applicazioni basterà aprire quel documento di 
Switcher, che automaticamente avvierà 1 programmi descritti. 


Come usare il manuale 


Questo manuale contiene le informazioni necessarie per creare un numero illimitato di 
combinazioni con le applicazioni che preferite ed ë organizzato come si stesse usando 
Switcher. Inizia con una breve descrizione del suo funzionamento, suggerisce come 
configurare 1 vostri dischi di lavoro e come utilizzare ogni funzione di Switcher, dalla 
più semplice alla più complessa. - L'appendice A, "Esercitazioni con Switcher” vi 
guiderà passo dopo passo attraverso le funzioni di base del prodotto. 

Il manuale presuppone la conoscenza di Macintosh, ta guida per l'utente, e almeno di 
una applicazione che lavora su Macintosh. 


Requisiti Hardware 


Switcher ë stato progettato per Macintosh con almeno 512K di memoria. L'utilizzo di 
un drive esterno per gestire applicazioni e documenti ë vivamente raccomandato. Il 
prodotto puó essere usato anche con un Macintosh XL e con hard disks costruiti per 
Macintosh. 


Requisiti Software 


Switcher lavora con la maggior parte del software prodotto per Macintosh da 128K. E' 
possibile che alcuni prodotti funzionanti esclusivamente per Macintosh da 512K non 
siano compatibili con Switcher. I produttori di software o il vostro fornitore vi daranno 
maggiori informazioni sulla possibilità di usare 1 prodotti esistenti con Switcher. 


Limitazioni del prodotto 


Sebbene la Apple Computer abbia collaudato Switcher e sia soddisfatta delle sue 
prestazioni e della sua qualità, non può garantire che ogni particolare applicazione c 
combinazione di applicazioni funzioni correttamente con questo prodotto. II manuale 
aiuta a raggiungere la massima affidabilità identificando le potenziali aree critiche e 
suggerendo configurazioni sicure. Si veda comunque il lato interno di copertina per i! 
testo completo della garanzia. 


Cosa fa Switcher 





Come Switcher ë un programma che fa da intermediario fra le applicazioni di Macintosh ed i! 
suo Sistema Operativo (il Sistema Operativo ë il software di base costruito dalla Apple 

lavora per il Macintosh e permette alle applicazioni di usare la memoria, le finestre, i menu e le 

Switcher altre funzioni del computer). À differenza di quanto accade abitualmente, Switcher 
intercetta e sostituisce alcuni comandi che le applicazioni indirizzano al Sistema 
Operativo. in modo di creare il suo proprio ambiente di lavoro. 
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Switcher permette infatti di avviare o installare le applicazioni che volete usare, 
assegnando a ciascuna uno slot specifico tra quelli disponibili. Dopo che 
un'applicazione è stata installata, Switcher gli riserva una determinata quantità di 
memoria (di solito 128K) che l'applicazione puó usare in maniera vincolante, senza 
poterla superare anche se puó esserci memoria non utilizzata. 

Switcher controlla inoltre il modo di visualizzare le applicazioni sullo schermo, 
permettendo di farle scorrere come se fossero su di una "ruota" e di ritornare al suo 
ambiente in qualunque momento. 
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Questa sezione del manuale contiene una veduta d'insieme di Switcher e descrive come 
usare le funzioni di base del prodotto, come usare un'applicazione lavorando con 
Switcher € come creare un documento di configurazione delle applicazioni abituali. 

Per avere esempi più dettagliati, si veda l' Appendice A "Esercitazioni con Switcher”. 


Configurazione dei dischetti 


Switcher lavora meglio se tutte le applicazioni e 1 documenti che volete usare sono 

disponibili su un unico disco. In questo modo si evitano cambi di disco da parte vostra 

e "confusione" da parte delle applicazioni. Sarà quindi molto più facile lavorare 
arando una configurazione adatta dei dischi, prima di avviare Switcher. 

Con due unità disco disponibili, ecco la configurazione che vi raccomandiamo per i 

vostri dischetti. 


DISCO RUUIO DISCO ESTERNO 


(| Cartella Sistema Applicazioni 


switcher bocument d 
Applicazioni 
Documenti n 


Per evitare confusione, si dovrebbero avere gli elementi di sistema (Finder, System e 
gli accessori della scrivania) su di um solo disco. E' bene ncordare che alcune 
applicazioni (incluso MacDraw) richiedono che una copia della risorsa di stampa (un 
elemento nella Cartella Sistema con lo stesso nome della stampante, come ImageWriter 
o LaserWriter) sia sullo stesso disco che contiene l'applicazione; altre come MacWrite 
richiedono che i documenti da stampare siano sul disco con la risorsa di stampa. 


Documenti 
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Per avviare Switcher 


Switcher si avvia come una qualsiasi altra applicazione, facendo due volte clic 
sull'icona che lo rappresenta. Dopo questa operazione su video compare il menu 











principale del programma: 
Pulsante di 
interruzione 
é Archivlo Composiziane Switcher 
Slot Con un doppio clic lanci uns epplicazione... 





Con un doppio clic lanci uns epplicazione... 





Con un doppio clic tanci una applicazione... 


Lo schermo di Switcher contiene una finestra e la solita barra dei menu. La finestra è 


suddivisa in aree rettangolari che indicano gli slots per le applicazioni: sono otto in tutto - 


e si usa la barra di scorrimento per visualizzare quelli che non compaiono sullo 
schermo. 

I menu Mela e Composizione sono standard; i menu Archivio e Switcher contengono i 
comandi del programma. Sul lato destro della barra di scorrimento si trova il pulsante 
di interruzione (una freccia bidirezionale) che appare sempre nella stessa posizione 
sulla barra dei menu di ogni applicazione installata con Switcher. 
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Installazione delle applicazioni 


La prima operazione da compiere dopo aver avviato Switcher ë quella di installare le 
applicazioni da usare. Potete Installare tutte le applicazioni che vi servono all'inizio del 
lavoro, oppure installarne una, iniziare a lavorare con quella e aggiungere o rimuovere 
altre applicazioni piü tardi. 

Per installare un'applicazione, selezionate uno slot libero e fate clic due volte. Nella 
finestra di dialogo che vi viene presentata, selezionate l'applicazione da installare e fate 
clic sul pulsante Apri, o fate clic sui pulsanti Unità Disco o Espelli per prendere un 
programma contenuto su di un altro disco. 


! 
MacDraw i MacDraw disk 


MacWrite 


¡Y T 


Switcher installa l'applicazione selezionata, la lancia e vi riporta allo schermo di inizio, 
che ora mostra l'icona dell'applicazione nello slot. Potete ripetere l'operazione per 
installare un'altra applicazione o usare quella appena installata. 


é Archivio Composizione Switcher 


Applicazione 
installata 
MacDraw 


k 
Con un doppio clic lanci une epplicaztone... 


Con un doppto clic lanci une applicazione.. 


Lon un doppio clic lanci una applicezione.. 
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Pulsante di 
interruzione 


Per ritornare a 
Switcher 


Ruota a destra 


Ruota a sinistra 


Utilizzo delle Applicazioni con Switcher 


Una volta installate le applicazioni da usare, siete pronti per sfruttare al meglio un 

prodotto come Switcher. potete lavorare con una applicazione normalmente e poi 

passare ad un'altra in qualsiasi momento. Per terminare dovete registrare il lavoro in 

opni applicazione, perchè il salvataggio di un documento non significa quello di tutti gli 
tri 


Per lavorare con una applicazione 


Dallo schermo di Switcher, si può attivare direttamente un'applicazione facendo due 
volte clic sullo slot che la contiene. Dallo schermo di Switcher o dall'intemo di 
un'applicazione, facendo clic su Sarg dı interruzione vi spostate invece alla 
prossima applicazione o alla precedente, a seconda che abbiate premuto sulla freccia 
destra o Sinistra. 

In qualunque modo abbiate attivato un'applicazione, subito potete lavorarci. 


jane Switcher 


Tropes installate 


doppio clic lanci una applicazione... 


Per ruotare tra le applicazioni potete anche usare la tastiera come scorciatoia: premendo 
contemporaneamente i tasti Comando e 1 si ruota a sinistra, usando invece Comando e $ 
si ruota verso destra. 
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Per ritornare allo schermo di Switcher 


Ci En diversi modi per ritornare a Switcher da un'applicazione, usate la tecnica che 
preferite. 


* Con un clic sul centro del pulsante di interruzione ritornate immediatamente allo 
schermo di Switcher. 


Ricerca Formato Caratteri Stile 
Senza Titolo 


* Scegliete Switcher dal menu Mela dell'applicazione in uso; il comando viene aggiunto 
appositamente in fondo al menu Mela per poter ritornare allo schermo di Switcher. 


Sceita Stampante 
Archivio Appunti 
Orologio Suegiia 
Blocco Note 
Caicolatrice 
Tastiera 

Pannelio di Controllo 
Puzzie 


Switcher 


* Tenete premuto il tasto Comando e battete il tasto Ritorno. 
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Registra lo Schermo 
acceso 


Registra lo Schermo 
spento 





Registrazione dello schermo 


Switcher può PONSO velocemente da un'applicazione all'altra se conserva 
un'istantanea dello schermo di ogni programma in memoria. Questo permette di avere 
l'immagine video di ogni applicazione non appena si passa da una all'altra. Questa 
operazione è regolata dal parametro Registra lo Schermo e richiede 22K di memoria per 


applicazione. Se scegliete di non salvare l'immagine video avrete maggiore memoria 


disponibile ma il tempo di passaggio tra le applicazioni aumenterà comunque € alcune di 
esse non saranno in grado di ridisegnare lo schermo con precisione. 





é Archivio Eomposizisne Switcher 








Finder 


MacDraw 


MacWrite 


Con un doppio clic lanci une applicazione... 


Dallo schermo di Switcher potete atuvare o disattivare il parametro Registra lo Schermo: 
se fate un clic sullo schermo dell'icona di Mac in uno slot occupato accendete o 
spegnete il parametro per quella particolare applicazione. Nell'esempio precedente gli 
schermi di Finder e MacWnte venivano salvati tra gli scambi di applicazioni, mente 


quello di MacDraw no (osservate in figura il simbolo che indica questa situazione). 


Per risparmiare memoria, potete disattivare Registra lo Schermo a livello generale prima 


di installare una qualunque applicazione (si veda pag. 8). 


Osservate che Registra lo Shermo non significa salvataggio del lavoro quando si passa 


da una applicazione ad un'altra e nemmeno che il documento in uso viene perso se 1! 
atti si richiedono all'interno di ciascuna 


parametro non è selezionato, le registrazioni inf 


applicazione e non hanno nulla a che vedere con questa opzione di visualizzazione. 


Attenzione! Dopo aver spento Registra lo Schermo per una o più applicazioni, può 
derlo a causa delle modifiche 


verificarsi che non ci sia abbastanza memoria per riaccen 
apportate all'ambiente di lavoro: in questo caso Switcher emette un segnale acustico. 
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Per salvare la configurazione in un Documento di Switcher 


Prima di uscire da Switcher o da una qualunque applicazione installata, & possibile 
registrare le informazioni sulla configurazione per poterla ricreare più avanti senza 
dover reinstallare le applicazioni. Switcher fornisce un metodo facile per ricostruire una 
configurazione delle applicazioni attive in un dato momento, permettendo di 
registrare le informazioni sulla loro installazione in un documento. 

Un documento di Switcher lavora in modo pressochè uguale a qualsiasi altro 
documento di Macintosh: quando si apre dal Finder, il documento lancia Switcher per 
voi e le informazioni che contiene fanno sì che vengano caricati tutti i document e le 
applicazioni che compaiono nella configurazione. 


Creare un documento di Switcher è semplice: avviate il programma e installate tutte le 
applicazioni da usare; se volete che un'applicazione apra un particolare documento, 
scegliete il comando Usa il Documento (descritto a pag.19) dal menu Archivio. Quando 
siete soddisfatti della configurazione, scegliete Registra la Configurazione sempre dal 
menu Archivio e vi sarà chiesto di dare un nome al documento - sceglietene uno che sia 
significativo. 


“< PTT Composiziene Switcher 


ik 


Applicazioni installate 


Nome Configurazione MacDrow ... 


[Finder,Draw,Write | 
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Switcher 








Dopo aver registrato la configurazione, potete continuare a lavorare. La prima volta che 
ritornate al Finder, vedrete il documento di Switcher che avete creato. Selezionatelo; : 
scegliete il comando Informazioni dal menu Archivio e registrate le informazioni BN 
sull'insieme della configurazione nella finestra del documento mentre ancora SONO E 
fresche nella vostra mente. Probabilmente costruirete parecchi documenti di Switcher, Ii 
ognuno con configurazioni differenti. 
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=== Informazioni su Finder,Draw, Write = = š " 


Finder,Draw,Write 
Tipo: Switcher documento 


Dimensioni: 154 byte, 1K nel disco 
Situato: MacDraw disk, unità disco esterna 


treato: Uenerdi, 2? settembre 1985 alle 18:22 
Modificete: Uenerdi, 2? settembre 1985 alie 18:22 
[]Protetto 


Draw è configurato con 140K, Finder e Write con 128; 
MacWrite è ianciato sul documento CAPITOLO 1 I 











Finestra Informazioni 
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Per trasferire informazioni tra le applicazioni 


In condizioni operative normali, non sarà possibile copiare le informazioni da 
un'applicazione per incollarle direttamente in un'altra perchè ogni applicazione usata 
con Switcher conserva i propri Appunti. Per trasferire le informazioni tra le 
applicazioni, è possibile usare il Blocco degli Appunti o richiedere a Switcher di È 
trasferire automaticamente gli Appunti. i 
Questa richiesta si ottiene in modi diversi: per trasferire gli Appunti tra due applicazioni 
particolari, tenete premuto il tasto Opzione mentre fate clic sul pulsante di interruzione; 
per ottenere il trasferimento automatico degli Appunti tra tutte le applicazioni che li 


usano, dovete invece agire sui parametri di Switcher nel comando Opzioni dal menu 
Switcher (si veda Trasferisci sempre gli Appunti a p. 13). 
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Per uscire dalle applicazioni 


Mentre usate Switcher, potete uscire da un'applicazione perchë avete concluso il lavoro 
o per lasciare libera piü memoria per avviare un'altra applicazione. Da un'applicazione 
si esce nel modo consueto: attivatela, registrate le modifiche e scegliete Esci (o il 
comando equivalente) dal suo menu Archivio. 

Uscire da un'applicazione significa rimuoverla dall'ambiente di Switcher, liberando lo 
slot e la memoria che gli era stata assegnata Per uscire dal Finder, dovete attivarlo e 
fare un doppio clic sull'icona di Switcher come se voleste lanciarlo: Il Finder è rimosso 
e si ritorna al menu di Switcher. 


Per installare applicazioni aggiuntive 


Per installare altre applicazioni mentre state lavorando, ritornate allo schermo di 
Switcher e ripetete le fasi per installare un'applicazione. (Può rendersi necessario uscire 
da un'applicazione per guadagnare memoria in più). Con un Macintosh da 512K, 
utilizzando le opzioni standard di Switcher, si possono installare fino a tre applicazioni 
usando per ognuna 128K di memoria. Per installarne di più applicate alcune delle 
tecniche di risparmio della memoria (si veda a pag. 18). 


Avviare Switcher da un suo documento 


Per lanciare Switcher su di un insieme predefinito di applicazioni, aprite il documento 
che le contiene invece di aprire Switcher stesso, il programma si avviera, installera tutte 
È applicazioni e vi lascerà in quella che occupa il rpimo slot da cui potrete iniziare a 
avorare. 

Si può anche caricare una configurazione dal menu di Switcher scegliendo il comando 
Carica la configurazione dal menu Archivio. Se avete già installato applicazioni, 
Switcher carica solo quelle che la memoria disponibile permette. 

Si veda Carica la Configurazione a pag. 20 per ulteriori informazioni. 


Uscire da Switcher 


Non c'è ragione di uscire da Switcher se non volete spegnere il Macintosh o usare 
un'applicazione che sia incompatibile o che abbia bisogno di tutti i 512K di memoria 
centrale. Negli altri casi potete uscire da una O tutte le applicazioni e rimanere in 
Switcher. 

Se volete comunque uscire dal programma, bisogna passare per Ogni applicazione, 
registrare il lavoro ed uscire; quando ritornate a Switcher scegliete Esci dal menu 
s o in alternativa fate clic sul pulsante di spegnimento della finestra Applicazioni 
nstallate. 

Se invece volete solo avviare un'applicazione, uscite da quella in uso e avviatene 
un'altra dallo schermo di Switcher. 

Potete uscire dal programma quando una applicazione ë ancora installata: scegliete Esc: 
e vi ritroverete nell'ultima applicazione attiva. 


In generale assicuratevi di registrare € di uscire da ogni applicazione singolarmente. 
Non dovete mai spegnere il Macintosh prima di aver eseguito queste operazioni. 
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Le opzioni predefinite in Switcher hanno caratteri di generalità e probabilmente non 
avrete mai bisogno di cambiarle. In ogni caso il programma ë particolarmente flessibile 
e permette di cambiare i parametri di configurazione, le opzioni sull'uso e l'estetica del 
suo ambiente di lavoro. 


Le Opzioni di Switcher 


Switcher pud essere adattato alle proprie esigenze con il comando Opzioni dal menu 
Switcher che produce la visualizzazione della seguente finestra di dialogo: 


jh, Opzioni di Switcher 


[1Switcher nella Rotazione 

O Trasferisci Sempre gli Appunti 

X] Ruota con Animazione 

RI Ritorna Dopo il Lancio 

O La Stessa Applicazione Due Volle 
O Inverti le Direzione di Rotazione 


[C] Disabilita i Comandi da Tastiera 


Cancella 


I parametri possono essere attivati o disattivati in ogni momento e sono ricordati da una 
sessione all'altra. 


Switcher nella Rotazione. Quando si fa clic sul pulsante di interruzione, 
una delle applicazioni a cui si passa è Switcher stesso. 


Trasferisci sempre gli Appunti. Quando usate Switcher, ogni applicazione 
mantiene i propri Appunti separati, in modo da poter normalmente tagliare, copiare e 
incollare all'interno della applicazione stessa. Selezionando Trasferisci Sempre gli 
Appunti potete invece convertire le informazioni da un'applicazione all'altra 
automaticamente. In questo caso ogni volta che si passa ad un'altra applicazione. 
Switcher trasferisce il contenuto degli Appunti dall'applicazione corrente alla 
successiva: noterete che nel passaggio si impiegherà più tempo. 

Potete annullare gli effetti di Trasferisci Sempre gli Appunti, tenendo premuto 1l tasto 
Opzione quando passate alla successiva applicazione: infatti se il parametro non è 
selezionato, con il tasto Opzione abbassato gli Appunti sono trasferiti solo per le 
applicazioni scambiate; se al contrario è selezionato, con Opzione abbassato non SI 
verifica il trasferimento. 

Dato che questa opzione aumenta il tempo di scambio e potrebbe causare problemi con 
alcune applicazioni, suggeriamo di non attivarla e di premere invece il tasto Opzione 
quando si ha bisogno di trasferire gli Appunti all'applicazione successiva. 
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Ruota con Animazione. Quando questa opzione ë richiesta, le applicazioni s! 
vedono "scorrere" su video nel passaggio dall'una all'altra. Se l'opzione non ë attiva, 
l'animazione non viene mostrata e l'applicazione successiva appare in un unico istante. 
vo si tratti semplicemente di una questione estetica, l'animazione impiega un po 
iü di tempo. 
uota con Animazione è una delle opzioni predefinite. 


Ritoma dopo il lancio. Questa opzione serve a riportarvi allo schermo di Switcher 
dopo aver installato una nuova applicazione o dopo aver avviato un'applicazione 
inattiva. In questo modo potete continuare ad installare applicazioni o scegliere 
direttamente quella con cui lavorare con due clic clic sul suo slot. Se Ritorna Dopo ü 
Lancio non è selezionato, si rimane nell'applicazione installata. Quando si avvia o si 
carica un documento di Switcher il parametro viene ignorato. Ritorna Dopo il Lancio è 
una delle opzioni predefinite. 


Questo parametro può interferire con le sequenze d'inserimento dei dischi quando si sta 
installando un prodotto software protetto che richiede il disco originale per iniziare a 
lavorare. L'applicazione in questione espelle il disco di copia e chiede quello originale, 
ma Switcher prende il controllo, ritorna al suo ambiente prima che si possa inserire il 
nuovo disco e chiede quello espulso. Quando ritornate all'applicazione, questa aspetta 
ancora il disco originale; bisogna allora espellere il disco con i tasti Comando-Maiuscole- 
1 02 per inserire il disco che è richiesto. Se questa sequenza vi sembra disorientante, 
sarà meglio disattivare la selezione del parametro. 


La Stessa Applicazione Due Volte. Se selezionate questa opzione, potete 


caricare la stessa applicazione due volte dallo stesso disco; in caso contrario Switcher vi 
permette di avviare l'applicazione solo una volta. 


Questa opzione presenta qualche rischio, perchè alcune applicazioni (compresi 
MacWrite e MacPaint) creano speciali archivi temporanei o non sono ideate per trattare 
eventi software che li riguardano e che accadono a loro insaputa. Perciò potrebbe non 
essere sicuro lanciare copie multiple di maggior parte delle applicazioni. E' invece 


sicuro avviare due copie di un'applicazione, se una delle due è su un disco differente; in 


questo caso, non sarà nemmeno necessario selezionare il parametro. In generale, non è 
mai sicuro lanciare due copie del Finder. 


Inverti la Direzione di Rotazione. Questa è un'altra opzione con effetti 
esclusivamente estetici. Quando fate clic sulla freccia di destra del pulsante di 
interruzione, quale applicazione volete attivare? Quella a "destra" del pulsante? Oppure 
ia "ruota" delle applicazioni deve muoversi verso "destra", mostrando l'applicazione 
sulla "sinistra"? Dal momento che puó essere un argomento controverso, la decisione ë 
lasciata a voi. 


Disabilita i comandi da tastiera. Questo comando disattiva i comandi da 
tastiera di Switcher: Comando, Comando-$, Comando-Ritorno e la combinazione per 
l'Uscita di Emergenza (vedi pag. 26). In questo modo avete la possibilità di usare i 
comandi equivalenti nelle altre applicazioni (come per esempio Microsoft Word). 


Per assegnare memoria alle applicazioni 


Switcher divide la memoria e la distribuisce alle applicazioni installate, ognuna delle 
quali lavora come se stesse usando un Macintosh dal28K; Switcher mantiene il 
controllo generale dell'ambiente di lavoro e vi permetie di passare da un'applicazione 
all'altra. 
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Switcher assegna automaticamente 128K di memoria alla maggior parte delle 
applicazioni oppure usa la quantità di memoria che avete stabilito con il comando 

onfigura e Installa. Nuove applicazioni ottimizzate per funzionare con Switcher 

saranno in grado di richiedere automaticamente la quantità di memona che occorre a 
loro per lavorare, In ogni caso potete assegnare più o meno memoria di quanto 
un'applicazione di solito richieda: se state usando un'applicazione che lavora in 
memoria come MacDraw, potrete assegnargli più memoria per costruire documenti più 
grandi. E' il comando Configura e Installa che vi permette di specificare la quantità di 
memoria da assegnare ad un'applicazione. | 
Quantitä di memoria diverse dalla misura prestabilita possono essere assegnate solo 
prima dellinstallazione di una applicazione. Alcuni programmi potranno non 
funzionare o avere dei problemi se viene loro assegnata una quantitä di memoria diversa 
da 128K. Per esempio, un'applicazione pud su TUE che se la disponibilità di memoria 
supera i 128K, si stia usando un Macintosh 512K, per cui si aspetta completamente 
questa quantità di memoria. E' inoltre difficile determinare la minima quantità di 
memoria che serve ad un'applicazione per lavorare. Bisogna sperimentarlo. Alcuni 
programmi avviseranno con il messaggio di "memoria insufficiente" l'utente che si ë 
assegnato troppa poca memoria. Applicazioni che lavorano in mernoria come MacDraw 
non saranno in grado di aprire grossi documenti. Altre ancora come il Finder 
lavoreranno con meno memoria, ma perderanno funzionalità (Il Finder per esempio non 
sarà in grado di ricordare quanti dischi si trovano sulla scrivania). 


La cosa migliore & quella di assegnare 128K a ciascuna applicazione oppure 
sperimentare misure diverse con dati poco importanti. 





Configurazione delle applicazioni 


Il comando Configura e Installa ë usato per assegnare una particolare quantità di 
memoria ad un'applicazione o per verificare la configurazione permanente di una 
applicazione già installata. Per utilizzare Configura e Installa, fate clic su di uno slot 
vuoto nello schermo di Switcher, poi scegliete Configura e Installa dal menu Switcher e 
selezionate l'applicazione da installare dalla finestra guida. Dopo la scelta viene 
presentata la seguente finestra di configurazione: 
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Applicazione che si 
sta configurando 


Se disponibile, la 
quantitä di memoria 
riservata 
all'applicazione 


MecWrite : Configurazione 


Memorie Suggerita : Kb 


Memoria Minima : Kb 
La quantità minima di 
memoria necessaria 
all'applicazione per 
lavorare 


RI Registra lo Schermo 





Emporanen 


Conserva una copia 
dello schermo 


I valori si applicano a 
tutte le future sessioni 
di questa applicazione 


I valori si applicano 
solo a questa sessione 


Memoria Suggerita. E' la quantita di memoria che Switcher assegna 
all'applicazione; puó trattarsi di 128K, della quantità che avete fissato o di quella che 


l'applicazione richiede. 


Memoria Minima. E' la più piccola quantita di memoria che Switcher assegna ad 
un'applicazione, di solito 128K o una quantità precedentemente indicata. Non è 


fac scendere sotto i 64K. 


valore di questo parametro viene usato quando non c'è sufficiente memoria per 
assegnare la quantità di Memoria Suggerita. Se nemmeno la Memoria Minima può 


essere garantita, Switcher segnala un errore. 


Registra lo schermo. Questa opzione vi permette di ottenere il salvataggio 
dell'immagine video quando l'applicazione è avviata. Se non viene selezionata, 
l'applicazione è sempre avviata con Registra lo Schermo disattivato. 

La registrazione dello schermo fa sì che il passaggio da un'applicazione all'altra sembri 
più veloce, altrimenti il contenuto del video viene ridisegnato ogni volta che si passa 


all'applicazione vicina. 


a prima di installare 


Il parametro vi permette di impegnare o meno una parte di memori 
una applicazione; ma può comunque essere spento 0 acceso anche 


{si veda a pag. 9 una descrizione dettagliata). 


dopo l'installazione 


Permanente. Fare clic su questo pulsante & equivalente a premere 
OK i cui effetti durano nel tempo. Switcher infatti accetta i valori dei par 


r quella particolare 


l'applicazione in uno slot e usa 1 cambiamenti che avete inserito pe 
applicazione in tutte Je future sessioni di lavoro. Se volete installare una nuova 
applicazione basta semplicemente fare due volte clic su uno slot nello schermo 
dell'interruttore e selezionarla dalla finestra guida: le opzioni di memoria che avete 
scelto saranno operative anche per quell'applicazione. Se desiderate cambiare la 
SEN ae permanente, uscite dall'applicazione e di nuovo scegliete Configura € 


Installa. 
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Applicazione inattiva 








Temporaneo. Fare clic su questo pulsante significa richiedere una variazione ai 

tri di configurazione che durano solo per la sessione in corso. Switcher infatu 
accetta i nuovi parametri, installando l'applicazione ma considerando i cambiamenti solo 
per quella sessione; la configurazione permanente resta invariata. Premendo Return o 
Enter ë come fare clic sul pulsante Temporaneo. 


Cancella. Facendo clic su Cancella ritornate allo schermo di Switcher senza operare 
alcun cambiamento alla configurazione permanente e senza installare l'applicazione. 


Dopo aver impostato la configurazione di una applicazione con un clic sui pulsanu 
Permanente o Temporaneo ritornate allo schermo di Switcher; il nome dell'applicazione 
appare in uno slot con la parola configurato per mostrare che l'applicazione & inattiva 
(pli & stata assegnata rnemoria ma l'applicazione non ë ancora stata avviata). Per avviare 
l'applicazione, fate clic due volte sul suo slot o scegliete il comando Apri dal menu 
Switcher. L'applicazione viene caricata e il controllo ritorna allo schermo di Switcher. 
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Finder 


MacDraw 


Macwrite (configurato) 


Con un doppio clic lanci una applicazione. 


Se la quantità di memoria disponibile è minore di quella definita in Memoria Minima, 
viene emesso un messaggio d'errore e si ritorna allo schermo di Switcher; vedrete 
l'applicazione in uno slot con assegnato O (zero) K e la parola configurato. A questo 
punto potete toglierla con Rimuovi una Applicazione dal menu Archivio o se vi 
interessa caricarla cercate di recuperare memoria spegnendo Registra lo Schermo o 
uscendo da un'applicazione attiva. Quando avete eseguito queste operazioni, potete 
avviare l'applicazione che non aveva memoria sufficiente scegliendo Apri dal menu 
Switcher e di nuovo richiedendo le opzioni dalla finestra di Configurazione. Per sapere 
quanta memoria è disponibile prima di installare un'applicazione, si veda la finestra 
associata al comando Mostra le Informazioni descritto a pag. 22. 
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memoria e 
sicurezza 





La maggior parse delle caratteristiche ae Questo. para prestazioni significative di 


velocita, ris io di memoria e sicurezza. men) afo dà un'idea su come 
ottimizzare Switcher in base alle proprie esigenze. La velocità si riferisce alla quantità di 
tempo mp pa per passare da un applicazione all'altra. Il risparmio di memoria si 
riferisce opzioni richiedono memoria oltre a quella assegnata alle applicazioni. 
Dato che Switcher non può prevedere come è stata ideata una particolare applicazione, 
alcune opzioni potreb causare problemi, La sicurezza si riferisce infine alla 
configurazione e alle opzioni più sicure per la maggior parte delle applicazioni. 


Per aumentare la velocità 


Se volete passare da un'applicazione all'altra velocemente, disattivate i parametri 
Trasferisci Sempre gli Appunti e Ruota con Animazione (si veda a pag. 14) e attivate 
Registra lo Schermo per ogni applicazione (si veda a pag. 9). 


Per avviare Switcher velocemente conviene registrare su disco le configurazioni che 
usate abitualmente; dal Finder basterà aprire uno di questi documenti per ottenere 
l'installazione e il lancio della applicazioni. Si veda il paragrafo Registra la 
Configurazione. 


Un'altro modo per iniziare velocemente è quello di definire Switcher come applicazione 
di avvio in modo che quando accendete il Macintosh e inserite il disco di sistema e un 
disco con le applicazioni, Switcher viene lanciato automaticamente. Per definire 
Switcher come applicazione di avvio, selezionate la sua icona dal Finder e scegliete il 
comando Avvia con dal menu Strumenti. 

Se inoltre desiderate lanciare il programma su un particolare documento dovete 
chiamarlo "Switcher.startup". In questo modo Switcher non solo si avviera 
automaticamente ma caricherà la configurazione prevista dal documento. Se 
all'accensione non volete usare il documento Switcher.startup, tenete premuto il tasto 
Opzione mentre il Macintosh si sta avviando. 


Per risparmiare memoria 
E' possibile risparmiare memoria: 
* assegnandone la minor quantità possibile ad ogni applicazione (si veda pag. 14); 


e uscendo da applicazioni che non si stanno più usando; 


« spegnendo Registra lo Schermo per ogni applicazione (si veda pag. 9). 
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I menu di 
Switcher 


Sono quattro i menu sullo schermo di Switcher: Mela, Archivio, Composizione e 
Switcher. Il menu Mela è standard, ad eccezione di quando ci si trova in 
un'applicazione; in questo caso contiene in fondo alla lista un comando di ritorno a 
Switcher stesso. I menu Composizione invece ë attivo solo se state usando un 
accessorio della scrivania richiesto con i comandi standard del menu Apple. 


li Menu Archivio 













Archivio 
Carica le Configurazione... 
Registra la Configurazione... 
Usa un Documento... KU 


GARANTITI Portare ra RS AMA PUTA seb erent rent 


Mosira le Informazioni 


APA BE need . ...............................ÁÑ... 4. 


Escl 


Carica la configurazione. Permette di scegliere un documento di Switcher da 
caricare. Ogni applicazione della configurazione viene installata e lanciata ed alla fine il 
programma vi riporta nell'applicazione che occupa il primo slot. Le applicazioni e i 
documenti della configurazione devono trovarsi sui dischi già inseriti nel Macintosh 
perchè Switcher può caricare solo quelli già conosciuti dal Finder. Se Switcher non 
riesce a trovare un'applicazione o un documento mentre carica una configurazione, 
interrompe il caricamento e ritorna al suo ambiente. 


Prima di scegliere il comando Carica la Configurazione è consigliabile uscire dalle 
applicazioni attive per lasciare spazio a quelle da caricare; altrimenti Switcher cancherà 
solo le applicazioni che la memoria potrà contenere. 


Carica la Configurazione ignora il parametro Ritorna dopo il Lancio. Dopo che 
Switcher ha caricato tutte le applicazioni, vi riporta all'applicazione che occupa il primo 
slot. 


Se Switcher incontra una copia software protetta che richiede un disco originale (come 
le applicazioni Microsoft), il dischetto d'avviamento verrà espulso per continuare a 
caricare le applicazioni. Quando poi ritornate all'applicazione, espellete i! disco 
dall'unità interna premendo i tasti Comando-Maiuscole-1 o dal drive esterno con i tasti 
Comando-Maiuscole-2 e inserite quello originale che l'applicazione legge e poi espelle; 
da quel momento potete reinserire il disco giusto € riprendere a lavorare. 


Dopo aver registrato una configurazione su disco 0 caricato un documento di Switcher, 
qualsiasi cambiamento decidiate di apportare al numero di applicazioni installate o a 
loro parametri non intaccherà il contenuto precedentemente salvato nel documento 
stesso. 


Registra la Configurazione. Registra l'insieme delle applicazioni installate, i 


valori dei parametri e delle opzioni in un documento di Switcher che pud essere avviato 


+ 


dal Finder o caricato con il comando Carica la Configurazione. 
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Norne del documento 
da usare 


Usa il Documento. Permette di definire i! nome di un documento che deve essere 
da un'applicazione quando ë installata a parüre da una configurazione di 
Switcher. Per far usare un documento ad una applicazione, passate allo schermo di 
Switcher e selezionate lo slot che vi interessa; scegliete Usa il Documento dal menu 
Archivio e nella finestra con la lista di tutti i documenti che possono essere aperti 
dall'applicazione selezionate quello che vi serve e fate clic sul pulsante Apri. Il nome 
del documento verrà mostrato nello slot dell'applicazione sullo schermo di Switcher. 
Se l'applicazione era attiva, il documento appena selezionato non ë aperto e quello 
attualmente in uso non viene modificato. Se l'applicazione ë disattivata, il documento 
verrà aperto quando si avviera l'applicazione. 


Dopo aver selezionato un documento con Usa il Documento, il comando Registra la 
Configurazione salva i suoi riferimenti nel documento di configurazione di Switcher. 
Documenti aperti dall'interno di un'applicazione non sono tenuti in considerazione al 
momento del caricamento di una configurazione. 
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Mostra le informazioni. Viene presentata la finestra delle Informazioni di 
Switcher contenente in forma grafica l'occupazione di memoria per le applicazioni in 
uso. Potete usare queste informazioni per configurare meglio il vostro ambiente di 
lavoro. 


hivio fpmposiziane Switcher <> | 
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¿===> = Informazioni su Switcher === 


Y MecDraw 
Memoría libera 


La barra associata ad ogni applicazione rappresenta la distribuzione della memoria. 
L'area grigio-scura mostra quanta memoria si sta effettivamente usando, l'area grigio- 
chiara mostra quanta memoria ë ancora disponibile per l'applicazione. Si notera che le 
cifre relative all'occupazione di memoria non raggiungono la cifra totale di 512K o di 1 
Mb per il Macintosh XL perchè la memoria ancora disponibile è usata in parte da 
Switcher stesso, dal Sistema Operativo e dalla funzione Registra lo Schermo. La 
memoria disponibile è solamente una stima per difetto del valore reale. Se la memoria 
disponibile è leggermente inferiore alla quantità necessaria, si può comunque tentare di 
installare un'applicazione; sarà Switcher a segnalarvi se non c'è abbastanza memoria 
disponibile. 


I! nome de! programma che è selezionato nella finestra Applicazioni Installate è marcato 
con un "visto" e rappresentato da uno schermo in miniatura. Facendo clic sul piccolo 
schermo vi ritrovate nell'applicazione stessa. Lo schermo in miniatura non appare se il 
parametro Registra lo Schermo è spento. 


Potete lasciare sulla scrivania la finestra con le informazioni e muovervi fra questa e la 
finestra Applicazioni Installate per tenere sous conuoito la memoria disponibile mentre 
installate le applicazioni. 


ESCI. Produce la conclusione di Switcher ed è equivalente a fare clic sul pulsante di 
spegnimento della finestra principale. 


Switcher 
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Apri. Lancia un'applicazione inattiva selezionata e vi permette di lavorarci. 


Ruota a Sinistra. Ha lo stesso effetto di quando si fa clic sulla freccia che punta 
verso sinistra del pulsante di interruzione. 


Ruota a destra. E' come fare clic sulla freccia che punta verso destra nel pulsante 
di interruzione. 


Opzioni. Presenta la finestra delle opzioni descritta a pag. 13. 


Questa sezione tratta argomenti specifici e situazioni che si possono incontrare dopo 
aver familiriarizzato con Switcher. 


Per installare Quattro Applicazioni da 128K 


Usando le opzioni predefinite di Switcher, con un Macintosh 512K & possibile 
installare tre applicazioni da 128K ciascuna. Se invece desiderate installarne quattro, 
utilizzate il comando Configurae Installa per cambiare il valore della memoria suggerita 
e spegnete l'opzione Registra lo Schermo prima di avviare un'applicazione. Se Registra 
lo Schermo ë attivo per una particolare applicazione, non sarà possibile installare la 
quarta perché richiederà piü memoria di quanta ne sia disponibile. Utilizzate la finestra 
Informazioni di Switcher per controllare il consumo di memoria quando installate. 


Se sono già caricate 3 serie da 128K e volete installare la quarta, spegnete 
Registra lo Schermo per le applicazioni e utilizzate Configura e Installa per caricare la 
quarta. 


Queste istruzioni valgono anche per installare tre applicazioni da 128K su di un 
Macintosh XL da 512K oppure sette applicazioni su di un Macintosh XL da IMD. 


Utilizzo di memoria inferiore a 128K. 


Alcune applicazioni possono lavorare con meno di 128K di memoria. Non esistono 
misure di confronto cui fare riferimento, ma semplicemente dovrete provare con diversi 
valori del parametro Memoria Suggerita usando il comando Configura e Installa. Se ii 
valore che definite è troppo basso, la maggior parte delle applicazioni segnalerà 


immediatamente che non può lavorare. 


La dimensione dei documenti di molte applicazioni è limitata dalla quantità di memoria 
disponibile: se create un documento usando 128K di memoria o più, non riuscirete ad 
aprirlo con Switcher se la sua applicazione viene configurata con una memoria 
inferiore. 
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Utilizzo di Applicazioni create per 512K 


Applicazioni che lavorano esclusivamente su di un Macintosh da 512K possono essere 
in grado di funzionare con Switcher con meno memoria. Provate ad installarle usando 
Configura e Installa con diverse misure della Memoria Suggerita. Alcune applicazioni 
non funzioneranno affatto e segnaleranno un errore di sistema (una finestra con l'icona 
di una bomba), altre comunicheranno che non c'š abbastanza memoria e fermeranno 
l'installazione ritornando allo schermo di Switcher. Comunque, in generale molte 
n oni saranno in grado di segnalare la quantità minima di memoria necessaria per 
unzionare. 


Switcher e il software " disco RAM" 


Esiste un prodotto software, chiamato "disco RAM" che permette alle applicazioni di 
lavorare piü velocemente. Questo programma puó trasferire la copia di un documento in 
memoria e lapplicazione che lo usa riceve dalla memoria le informazioni che 
usualmente riceverebbe da] dischetto, lavorando molto piü in fretta. Programmi di 
questo tipo sono di solito avviati prima del lancio di Switcher e quindi la quantità di 
memoria che utilizzano non sarà piu disponibile per la configurazione di Switcher. 


Per Usare Switcher con un Hard Disk. 


Switcher funziona senza problemi su di un hard disk: dovete semplicemente copiarlo e 
avviarlo sempre da li. Cuando si lavora con l'hard disk, solo un volume in linea 
dovrebbe contenere gli archivi di sistema. (Un volume in linea può essere un disco 
inserito di 31/2 pollici oppure uno o più volumi sull'hard disk, che appaiono come 
dischetti sullo schermo del Finder). 


Per Usare Switcher con la stampante LaserWriter 


Switcher è in grado di lavorare con la stampante LaserWriter sulla rete AppleTalk*M a 

condizione di aver eseguito correttamente le procedure di installazione del software che 

la gestisce. Tutti i prodotti software della Apple per Macintosh, eccetto MacWrite, 
ssono stampare con 128K di memoria occupata. Per stampare su LaserWriter con 
acWrite, è necessario installarlo con una Memoria Suggerita di 144K. 


Per Usare Switcher con un Macintosh XL 


Switcher è in grado di lavorare con Macintosh XL, sia con 512K che 1 Mb di memoria, 
utilizzando MacWorks (il prodotto software che permette ad un Macintosh XL di 
lavorare con i programmi per Macintosh). 


Ecco di seguito ciò che dovete sapere su Switcher e il Macintosh XL: 

* copiateSwitchersull'harddisk di XLe avviatelo sempre dali. 

« unMacintosh XL di $12K non é uguale aun Macintosh 512K: Mac Works 
richiede128K di memoria, cosi solo 384K restano disponibili per Switcher. Cio 
significa che potete installare 2 applicazioni da 128K con le opzioni predefinite o tre 


applicazioni da 128K usando la tecnica descritta in "Installazione di Quituc 
Applicazioni 128K" a pag. 22.- 
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» UnMacintosh XL da 1Mb fornisce molta più memoria per Switcher che un 
Macintosh 512K o un 512K XL. E' possibile installare sei applicazioni da 128K 
utilizzando le opzioni predefinite di Switcher o sette applicazioni da 128K usando la 
stessa tecnica descritta in "Installazione di quattro Applicazioni 128K” a pag. 22. 


° san bisognodi 128K di MemoriaMinima per lavorarecon unMacintosh 


Uscita di emergenza 


Se una delle applicazioni installate dovesse "bloccarsi" o emettere un messaggio con 
un'icona a forma di bomba non fate clic sul pulsante Riavvia e non spegnete Macintosh. 
E' possibile infatti recuperare il controllo del sistema uscendo dall'applicazione bloccata 
e ritornando allo schermo di Switcher senza danneggiare le altre applicazioni installate. 
Potete farlo premendo contemporaneamente i tasti Opzione-Comando-Maiuscole e il 
segno punto (.). Se il problema riguarda solamente una particolare applicazione, 
ritornerete allo schermo di Switcher senza danneggiare le altre; altrimenti la situazione 
potrebbe essere piü grave. 


Infatti quando un'applicazione si blocca ë possibile che danneggi la memoria di sistema 
in comune con le altre applicazioni installate. In ogni caso suggeriamo di registrare i 
vari documenti in uso e di uscire da ogni applicazione immediatamente; poi di uscire 
anche da Switcher e di riavviare Macintosh. 
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Questa breve esercitazione vi accompagna passo dopo passo attraverso le funzioni 

fondamentali di Switcher, usando MacWrite, MacPaint e il Finder. Avrete bisogno di 

un Macintosh da 512K con un'unità di disco esterna, MacWrite, MacPaint, il dischetto 

sr dischetti vuoti. Si richiede una conoscenza preliminare di MacPaint e 
ac Write. 


Per cominciare 


Preparerete due dischetti da usare con questa esercitazione; se vi servono informazioni 
su come copiare dischetti e documenti fate riferimento a Macintosh, la guida per 
l'utente. 

Per prima cosa preparate il disco A, che sarà quello di avvio. 


è Copiate il dischetto di Switcher (compresa la Cartella 
Sistema) su di un dischetto vuoto. Togliete qualsiasi 
documento in più per lasciare spazio a MacWrite. 


- Copiate MacWrite (solo l'applicazione, non il dischetto 
intero) sullo stesso disco. 


. Mettete l'etichetta "Disco A" sul disco appena 
preparato. 


Ora preparate il disco B, che verrà inserito nell'unità disco esterna. 
+ Copiate l'applicazione di MacPaint sul dischetto B. 


» Copiate qualsiasi documento di MacWrite o MacPaint 
che volete utilizzare sul dischetto B. 


. Mettetel'etichetta "Disco B" sul disco preparato. 


Il contenuto dei due dischetti dovrebbe ora essere il seguente: 


Disco A Disco B 
Cartella Sistema MacPaint 
MacWirite Document di MacPaint e 
Switcher MacWnte 
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Queste opzioni 
dovrebbero essere 
attive 


Per Installare le applicazioni 


Dopo aver avviato Switcher, decidete quali applicazioni volete usare installandole. 


Prima di farlo controllate che le opzioni di Switcher necessarie per questa esercitazione 
siano correttamente selezionate. 


. Scegliete Opzioni dal menu Switcher. 


Apparira la finestra Opzioni e le sole opzioni selezionate dovrebbero essere Ritorna 
dopo il Lancio e Ruota con Animazione. 












Opzioni di Switcher 





D Switcher nella Rotazione 

O Trasferisci Sempre gli Appunti 
/ 5 Ruota con Animazione 
5 Ritorna Dopo il Lancio 
O La Stessa Applicazione Due Volte 
(inverti la Direzione di Rotazione 


D Disabilita i Comandi da Tastiera 


. Selezionate Ritorna dopo il Lancio e Ruota con 
Animazione. Togliete la selezione a qualsiasi altra 
opzione. 


. Fate clic sul pulsante OK. 


Appendice A: Esercitazioni con Swiicher 29 


wo em 


epr te 


> — — u n anm en nim 


= a in "a= a vapa rer lm TS = ... 


an ar coy pal, E DOM ZI ORIO Tp a memi ERT SES 
= (dé Te sapa dic E AR IR > š “OW 








ern 











Ora siete pronti per installare le applicazioni. Cominciate dal Finder. 


Switcher 


Posizionate il Puntatore nel primo slot e fate clic due 


Con un doppio clic lanci una epplicazione. 


h. 


Con un doppio clic enc» una applicazione. 


Con un doppio clic lanci una applicazione 


Con un doppio clic lanci une spplicezione 





Potrete vedere le applicazioni disponibili sul Disco A: Finder e MacWnte. 
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» Selezionate Finder e fate clic su Apri. 





é Archivio formposizione Switcher Qo 





"a Applicazioni installate E 


«à Con un doppio clic lanci una applicazione. 


Lo schermo del Finder apparirà per un breve tempo e poco dopo ricomparirà lo 
schermo di Switcher dove vedrete il Finder nel primo slot. Potete ora installare la 
prossima applicazione, MacWnte. 
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. Fate clic sul pulsante Unità Disco. 


Vi verrà presentata la scelta disponibile sul disco B, MacPaint. 


- Selezionate MacPaint e fate clic su Apri. 


Apparirà per breve tempo lo schermo di MacPaint e come al solito verrà riproposto 
quello di Switcher che mostra tre slot occupati rispettivamente da Finder, MacWnte e 
MacPaint e uno vuoto. 


é Archivio fpmppsiziane Switcher > 





Applicazioni Installate 


Macwrite 


MacPaint 


Con un dogpis clic lanci una applicazione... 


A questo punto potete iniziare a lavorare con le applicazioni. 
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Per passare da una applicazione all'altra 


Potete passare direttamente ad un'applicazi 


one dallo schermo di Switcher facendo due 


volte clic sullo slot che lo contiene o potete fare clic sul pulsante di interruzione per 


ruotare fra Finder, MacWrite e MacPaint 


. Fate clic due volte sullo slot de! Finder. 


é Archivio Tomposiziene 





=== Applicazioni Installate 


Finder 


Macwrite 


MacPaint 





Switcher QD 


+ 


w—— 


Vi sara mostrato il solito schermo di Finder ma con una differenza: il pulsante di 
interruzione sara visibile sul lato destro delia barra dei menu. A questo punto potete 
fare tutto cid che di solito si fa con Finder, come copiare, rimuovere o cambiare nome a! 


document. 


Usate ora il pulsante di interruzione per passare 4 MacWnte. 


Switcher 
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. Fate clic sulla freccia rivolta a destra nel pulsante di 
interruzione. 


Pulsante di 
interruzione 


é Archivio Composizione Esposizione Strumenti oy 





Il Finder "scorre" via e viene avant MacWrite, con il quale potreste lavorare ma che 
lasciamo da parte per ruotare ancora tra le applicazioni. 
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* Fate clic sulla freccia destra del pulsante di 
interruzione. 


Ora ë MacPaint che appare sullo schermo. 


« Fate ancora clic sulla freccia destra del pulsante di 
interruzione. 


Ritorna lo schermo del Finder e la “ruota” della applicazioni è stata completata 


* Fate clic sulla freccia sinistra de! pulsante di 
interruzione. 


V; ntrovate alla precedente n i MacPaint 

E' come se le applicazioni fossero installate sopra una ruota dentata come quella 
Jiustrata a pag.3. 

Quando fate clic sul pulsante di interruzione, la ruota si muove avanti o indietro di una 
tacce per volta 
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Per ritornare allo schermo di Switcher 


Se volete aggiungere applicazioni o modificare i loro parametri di installazione, dovete 
ritornare a Switcher. 


* Scegliete Switcher dal menu Apple. 
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| informazioni su MacPaint... È ET no 


E QM AIR AU URS MM r e A ae 
i H _ÁK_. ———— Cru 
fida Senza Titolo The 
s np. 
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Dimensioni 






Sceits Stampante 
Archivio Rppunti 
Orologio Sueglia 
Blocco Note 
Calcolatrice 
Tastiera 

Pannetio di Controilo 
= Puzzle 
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Vi ritrovate allo schermo di Switcher. Il comando Switcher viene aggiunto in fondo al 
menu Apple di ogni applicazione per permettere di ritornare direttamente allo schermo di 
Switcher. 


Switcher 
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| E Per tagliare e incollare fra le Applicazioni 
| La configurazione predefinita di Switcher non vi permette di tagliare e incollare tra le 
| applicazioni installate. Per ottenerlo potete usare il tasto Opzione che trasferisce gli 
| a Appunti fra le applicazioni quando passate da una all'altra. 
1 ® . Fate clic sul pulsante di interruzione fino a 
| raggiungere MacPaint. 
| 
| “ * Disegnate un oggetto e selezionatelo con il lasso. 
! 
| m ° Scegliete Copia dal menu Composizione. 
I 
| * Tenete premuto il tasto Opzione e fate clic sul i 
ju pulsante di interruzione finché viene visualizzato lo E 
| à schermo di MacWrite. [ 
| < * Lasciate il tasto Opzione e scegliete incolla dal menu i 
| š Composizione. i 
N | 
+ 

| y € Archivio Composizione Ricerca Formato _Coratteri Qo i 
| è 
| è 
x sl 
| DI 
aL 
| IL DISEGNO CHE VEDETE E STATO TRASFERITO DAGL. 
| | APPUNTI Di MACPA!N™ 
| 
» 
| 
P 

I] disegno dell oggetto appare ne! documento di Macwrite. 
* Senza usare il tasto Opzione potete far trasferire gli Appunti direttamente a Switcher. Si 

veda a pag. 10. 
i è k 
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Un documento di Switcher permette di automatizzare la procedura d'installazione di 
alcune applicazioni. Dopo aver installato le applicazioni che volete usare insieme, potete 
creare un documento di Switcher e utilizzarlo le volte in cui ne avrete bisogno: bastera 
aprirlo dal Finder ed aspettare che Switcher installi tutte le applicazioni che vi servono. 


» Scegliete Switcher dal menu Apple per ritornare allo 
schermo del programma. 


. Scegliete Registra la Configurazione dal menu 
Archivio. 


. Scrivete "Finder/Write/Paint" per dare un nome al 
documento. 


Nome Configurazione 
Finder,Write,Pain 


Registra 
(Registra 


In questo modo viene creato un documento che si chiama "Finder/Writer/Paint", che 
potete vedere tornando a! Finder. 


Switcher 


Per creare un documento di configurazione 





Fate clic sul pulsante Registra. 
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Documento di 


Switcher 


é Archi 


6 element: 


@ DL 


MacPaint 


====== Disco B 
88K su disco 312K disponib 


Paint! 


LN 


2 


Fate chic sul pulsante di interruzione finche viene 
mostrato il Finder. 


Vedrete il documento di Switcher appena creato 


vio Composizione Esposizione Strumenti 


Paint2 
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Uscite ora da Switcher e avviatelo di nuovo dal documento che avete appena 
creato. 
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Per uscire da Switcher 
Potete uscire da Switcher solo se uscite prima da ogni applicazione singolarmente. 


. Ruotate fino a MacPaint facendo clic sul pulsante di 
interruzione. 


» Scegliete Esci dal menu Archivio. 


Vi sarà chiesto di registrare le eventuali modifiche. Scegliete SI o NO. MacPaint si 
conclude e vi ritrovate allo schermo di Switcher. 


. Attivate MacWrite facendo due volte clic sullo slot che 
lo contiene. 


- Scegliete Esci dal menu Archivio. 


Anche in questo caso vi sarà chiesto di registrare le eventuali modifiche; fate clic sui 
pulsanti SI o NO. MacWnite termina e vi ritrovate allo schermo di Switcher. 


L'unica applicazione ancora attiva ë il Finder, dal quale non occorre uscire perche 
Switcher può essere interrotto quando c'è solo un'applicazione attiva. 


. Dallo schermo di Switcher scegliete Esci dal menu 
Archivio. 


In questo modo uscite dal programma e ritornate al Finder. Osservate che il pulsante di 
interruzione è scomparso. 


Per avviare un documento di Switcher 


Avviate ora di nuovo Switcher, ma dal documento che è stato creato nel corso 
dell'esercitazione. 


. Fate due clic sull'icona del documento 
Finder/Write/Paint. 


Switcher si avvia e installa Finder, MacWrite e MacPaint. L'operazione impiega 
qualche secondo. Quando Switcher ha finito, vi riporta automaticamente al Finder O 
alla applicazione viene installata nella prima fessura. Il pulsante di interruzione € visibile 
sul lato destro della barra dei menu per ricordare che si sta usando Switcher e può 
essere usato per passare da un'applicazione all'altra. 

Per uscire ripetete le istruzioni sopra riportate. 


Con questa appendice abbiamo fornito una breve introduzione a Switcher. Per saperne 
di più su come lavora il prodotto e sulle sue funzionalità consultate il resto del manuale. 


Switcher 
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Limitazioni conosciute 


II Finder dovrebbe sempre essere la prima applicazione che si installa ed occupare il 
primo slot. 


Se tentate di avviare un documento di Switcher dal Finder già installato, non vi sarà 
permesso di farlo: i) Finder sarà interrotto e ritornerete allo schermo di Switcher. 


Se installate il Finder ed una applicazione senza aver attuato lopzione La Stessa 
Applicazione Due Volte non potrete stampare document di quella applicazione 
direttamente dal Finder perché Switcher tenta di installare l'applicazione la seconda 
volta. Con il parametro attivo invece potrete stampare un documento dal Finder. 


Quando attivate il Finder in presenza di altre applicazioni, avrete l'opportunità di vedere 
gli archivi temporanei che questi programmi stanno usando. Gli archivi hanno un'icona 
generica e sono indicati con i nomi Paint 1 e Paint? per MacPainte UndoFile e Archivio 
Appunti per MacWrite. 

Non cancellate quesü archivi, perché potreste perdere informazioni o provocare la 
caduta dell'applicazione; sarà questuluma a rimuovere queste icone quando viene 
conclusa. 


Font/Desk Accessory Mover 


I| programma Font/Desk Accessory Mover è un'applicazione contenuta sul disco 
Sistema (dall'Agosto 1985) e disponibile pressc i! vostro rivenditore Apple. 


La Stessa Applicazione Due Volte 
Non lavorate con Font Desk Accessory Mover, usando questa opzione. 
Dimensioni di Memoria raccomandate 


Memoria Suggerita: 128K 
Memoria Minima: 128K 


Limitazioni conosciute 


Non utilizzate Y programma mente avere alte applicazioni attive in Switcher. 
FonuDesk Accessory Mover camme infani il file Sistema e ciò potrebbe causare 
problemi ad altre applicazioni atuve. 


Switcher 
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MacWrite 


Queste informazioni fanno riferimento alla versione 4.5 e precedenti di Mac Wnte. 


La Stessa Applicazione Due Volte 
Non lavorate con MacWrite utilizzando questa opzione. 
Dimensioni di Memoria raccomandate 


Memoria Suggerita: 128K o più (144K per usare LaseW’riter) 
Memoria Minima: 128K (144K per usare LaserW nter) 


Limitazioni conosciute 
Nessuna. 


MacPaint 


Queste informazioni fanno riferimento alla versione 1.5 e precedenu di MacPaint. 


La Stessa Applicazione Due Volte 
Non lavorare con MacPaint utilizzando questa opzione. 
Dimensioni di Memoria raccomandate 


Memoria Suggenta: 128K o 179K 
Memoria Minima: 128k 


iavorate con MacPaint solamente con 128 o 179K. 
Limitazioni conosciute 


Nessuna. 
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MacDraw 
Queste informazioni fanno riferimento a MacDraw versione 1.9 e precedenti. 
La Stessa Applicazione Due Volte 

MacD aw può lavorare con questa opzione. 

Dimensioni di Memoria raccomandate 


Memoria Suggerita: 128K o più 
Memoria Minima: 128K 


Limitazioni conosciute 


Quando si usa MacDraw con Switcher non si dovrebbe mai superare 180% della 
memoria e non si dovrebbe copiare o incollare se in questo modo 180% di memoria 
viene superato. (Usate il comando MacDraw nel menu Mela per controllare l'utilizzo di 
memoria). 

Con Switcher un problema ad un disegno di MacDraw causa la caduta di MacDraw 
stesso se la memoria utilizzata eccede 180%. 


MacProject 

Queste informazioni si applicano alla versione 1.0 e precedenti di MacProject. 
La Stessa Applicazione Due Volte 

MacProject puó lavorare con questa opzione. 

Dimensioni di Memoria raccomandate 


Memoria Suggerita: 128K o piü 
Memoria Minima: 128K 


Limitazioni conosciute 


Nessuna. 


Switcher 
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e trasferire gli Appunti, 11, 13 
tra le applicazioni, 3, 7, 23, 34-35 
usando t! pulsante di interruzione, 7 
velocita' di rotazione, 13, 14, 16, 18 
verso lo schermo di Switcher, 8, 13 
tra le applicazioni, 3, 34 


S 
schermo di Switcher, 5, 14, 21, 23, 31, 32 
ritornare allo, 8, 9, 12, 13, 14, 22, 36 
scurezza 
e configurazione, 19 
in relazione a memona e velocita', 18 
sistema operativo, 2 
slot, 3, 5. 23 
scorrere tra gli, 5 
software che lavora 1n memoria, 26 
stato predefinito, 11 
Sirument vedi menu 
Switcher 
caraneristiche di base, 4 
comandi, 5 
come applicazione di avvio, 18 
controlio dell'ambiente di, 13, 22 
limitazioni, 1, 41-44 
velocita, 18 
Switcher nella Rotazione, 13 
System, Finder e pianificazione dei dischi, 4, 18, 24 
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taglia-copia-incolla tra le applicazioni, 11, 13, 37 


Trasferisci gli Appunti, 11, 13 


U 

unita’ disco 
1Mbyte vedi hard disk 
esterna, 1 


usare due, 4, 27 
Usa un Documento, 10, 21 
uscire da Switcher, 10, 12, 23, 40 


uscire dalle applicazioni, 10, 12, 18, 20, 23, 40 
uscita di emergenza da un blocco, 26 
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velocita, memoria e sicurezza, 18 
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Macintosh Switcher 


Switcher per il personal computer 
Macintosh! permette di lavorare con più di 
una applicazione 1n memoria allo stesso tempo. 
Con Switcher puoi spostarti tra le applicazioni 
di Macintosh e scambiare informazioni tra 
queste velocemente e facilmente, proprio 
come se le spostassi tra 1 fogli sulla tua 
scrivania. Switcher ti puó aiutare a lavorare in 
modo piü produttivo, sfruttando appieno le 
capacità di Macintosh 512 o Macintosh XL e 
creando da te dei pacchetti integrati di 
applicazioni. 


Compatibilità software 

Switcher lavora con la maggior parte delle 
applicazioni di Macintosh. 

11 miglior modo di utilizzarlo è seguire 
attentamente i consigli di questo manuale o le 
configurazioni testate direttamente dai 
produttori delle diverse applicazioni. Per 
qualsiasi problema rivolgiti al tuo rivenditore 
autorizzato. 


Questo manuale e il disco allegato contengono 
tutte le informazioni che ti serviranno pe: 
creare da te le configurazioni di Switcher. 
Non possiamo garantire l'affidabilità di tutte le 
applicazioni usate con Switcher, tuttavia 
troverai anche consigli su come ottimizzare `° 
prestazioni di alcune di queste applicazioni. © 
l'identificazione di potenziali problemi. 


Requisiti Hardware 

Switcher richiede un Macintosh 512K o ur 
Macintosh XL; raccomandiamo inoltre 1 uso d: 
una unità disco esterna o di un disco rigido su 
cui conservare applicazioni e documenti. 
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Using Switcher with 
Microsoft. Applications 


Microsoft Corporation 
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introduction 


Macintosh Switcher, licensed by Microsoft Corporation from 
Apple Computer, Inc., turns your 512K Macintosh or Macintosh 
XL into a multi-program workstation. 


You can use many of your favorite applications at once by allocat- 
ing portions of your Macintosh's memory to each application. 
Then. with all your applications in memory, you can quickly 
switch between them and share information. You don't have to 
wait to quit one application and start another. With Switcher, 

you click an arrow to move from application to application. 


Switcher works with all your Microsoft Macintosh applications: 
Excel. Word, File. Chart. Multiplan. and future Microsoft applica- 
tions. You've been amazed at the power of individual Microsoft 
applications. Now, with Switcher, imagine how swiftly and simply 
they'll work together. 





Using a Switcher Document 


This section describes the Switcher document that is provided on 
your disk and contains the basic information you need to use the 
document to combine two Microsoft applications. 


It explains how to: 


B Set up disks. 

m Start a Switcher document. 
g Switch between applications. 
m Transfer information. 

B Quit Switcher. 


= eee Bae | X" n `. adn 


Do vou spend most of your computing time using one Microsoft Why Switcher? 
application. but every so often needing to team it with another 

powerful application? Say. for instance, that you ve set up Some 

quick macros with Microsoft Excel to automate your sales projec- 

tions and create charts depicting actual variances. You want to 

include these Excel charts in your monthly report to your sales 

force. Use Switcher to combine the number genius of Microsoft 

Excel with the word savvy of Microsoft Word, and you're in busi- 

ness. _ Be: 
Your Microsoft application comes with a Switcher document that Microsoft makes 
automatically installs two applications that you'll most likely want using Switcher easy 
to use together. When you open the document Switcher installs, 

for example. both Excel and Word for you. Your Microsoft soft- 

ware is instantly “integrated.” 


If your Microsoft application comes with more than one disk. you 
can find the Switcher document on the disk that contains the Sys- 
tem folder. All Switcher documents arc named with the Microsoft 
product names separated by slashes. For example. the Switcher 


document on the Excel Program disk is named Excel X ord. 


You can get information about the Switcher document included 
on your disk by selecting the icon for the document and choosing 
the Get Info command from the Finder's File menu 


About This Guide 


This guide explains how to use Switcher and Microsoft applica- 
tions with a Switcher document supplied on your disk. It does 
not. however, describe general Switcher procedures or specific 
Switcher options. If you want to experiment with Switcher's 
options, ask your Apple dealer for Switcber. a more detailed guide. 


To use a combination of Microsoft applications other than the 
ones described in this guide, you must assign them specific 
amounts of memory. To find out what the memory require- 
ments for your applications are, see the relevant application in 
"Microsoft Applications," later in this guide. 


This guide has two main parts: 


m "Using a Switcher Document" explains how to start and quit 
the Switcher document supplied on your disk. 


B "Microsoft Applications" contains a section on each Microsoft 
application. Each section describes setup suggestions for vour 
disks, how to transfer information via the Clipboard, tips for 
avoiding problems. and minimum memory requirements. 


Important Switcher versions 4.0 and later have been tested to 
work with the Microsoft applications described in this guide. 
Microsoft is not responsible for problems caused by using 
Switcher with a non-Microsoft product. Microsoft and Apple 
Computer, Inc. cannot guarantee the reliability of every com- 
bination of applications used with Switcher. 
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[8] Double-click the icon for > 
the Switcher document. 
For example, double-click 
Excel/Word. Excel/Word 


Important As Switcher opens each application, a message tell- 
ing you to insert the master disk flashes on the screen, and your 
Macintosh ejects the internal drive disk. Ignore this message and 
reinsert the System disk. Switcher continues to load the other 
applications. Continue to ignore any messages to insert the master 
disk. Reinsert the system disk when your Macintosh asks for it, 
and wait until Switcher has loaded all your applications. 


After Switcher has loaded your applications, the menu bar for the When to insert the 
first application appears on your screen with the master disk mes- master Program disks 
sage. Now, insert the master Program disk for the first application: 


(m) Insert the master Program disk for the first application. 


Note If you see the master disk message. but your Macintosh has 
not ejected the internal drive disk. you can press Command-Shift-1 
to eject the disk. Then. insert the master Program disk. 


Follow the above instructions for inserting the master Program 
disk after you switch to each application. 


Switching Between Applications 


After you start up from your Switcher document, you can start 
working with each application and quickiy switch between them. 
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To switch to another application. you click either end of the To switch 
arrow at the upper-right corner of vour screen. Switcher moves 

you to the next or previous application, depending upon whether 

you click the right or left end of the arrow. 
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| To set up your disks 


' To start your Switcher 
document 


Setting Up Disks 


You must have a 512K Macintosh or a Macintosh XL to use 
Switcher. Apple also recommends you have an external disk 
drive. Switcher also works well with a hard disk. 


if you are using a two-disk drive system, you should set up two 
disks: one with Switcher and your System folder. and one with 
copies of your Microsoft applications. To avoid unnecessary disk 
swapping while using Switcher, spend a few minutes setting up 
your disks according to these general guidelines: 


Internal Drive Disk External Drive Disk 
System folder Copies of your Microsoft 
ImageWriter or LaserWriter applications 

document 

Switcher 


Switcher document 


Disk setup guidelines for Excel Word are different from the above. 
Before proceeding. see the section on Excel/Word in the next sec- 
tion, “Microsoft Applications.” 


Starting a Switcher Document 


After you have set up your disks, you are ready to start your 
Switcher document. 


[1] Turn on or restart your 
Macintosh. 

[2] Insert the System disk (con- 
taining vour System folder 
and Switcher ) into the inter- 


nal drive. 
[3] insert vour applications disk — You'll also need the master Pro- 
into the external drive. gram disk for each program on 


the applications disk. For exam- 
ple. if you are starting Excel/ 
Word. vou'll need the Excel 
master Program disk and the 
Word master Program disk. 
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Microsoft Applications 


This section describes each Microsoft application, any specific 
disk setup required to use the Switcher document supplied. exam- 
ples of transferring information. and any known limitations using 
Switcher with specific Microsoft products. 


If you want to install your own combination of applications. sec 
the “Preferred Memory Sizes” section for each application. 


Microsoft Excel 


Microsoft Excel includes the Switcher program and a Switcher 
document named Excel Word. If you have Microsoft Word. you 
can use the Excel Word document to combine your worksheet, 
database, and graphics functions with Word's word processing 


power. 
Setting Up Disks 


After vou make vour copies of the Excel Program and Excel Data 
disks: 


[f Move the Help file and all You need to have at least 160K To set up disks 
the sample documents from of space on the Data disk for 
your copy of the Data disk Word and its temporary docu- 
onto another disk. ments. You can always copy the 

Help file and sample docu- 
ments back to the Data disk if 
you want to use them later. 

{2} Copy the Microsoft Word 
application from the master 
disk onto the Excel Data 
disk bv dragging the icon 
for the Word applicauon. 
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To transfer Clipboard 
contents 


Click one end of the Switcher arrow to move to another application. 


” é Fie Edit Formula Format Dato Dptions Macro Window 
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If you click the middle of the Switcher arrow, you move to the 
Switcher screen. You can learn about this screen in Switcher. 
Click the right or left end of the arrow to return to your 
application. 


You can also use commands from your keyboard to switch 
between applications. Press Command-| to switch to the next 
application. Press Command. | to switch to the previous applica 
tion. Press Command-* (backslash ) to move to the Switcher 
screen. ( The Backslash kev is located directly below the Back- 
space kev.) 

Before vou start using the two applications included in vour 
Switcher document, read the sections in "Microsoft Applications" 
that pertain to your applications. Each application has guidelines 
vou should follow while using Switcher. 


Transferring Clipboard Contents 


When you are using Switcher, each application keeps its own 
separate Clipboard. So. you can Cut, Copy, and paste within each 
application as you normally would. 


When you want to transfer information from one application to 
another via the Clipboard. hold down the Option key when vou 
switch to the other application. Then, Switcher will transfer the 
Clipboard contents from the one application to the other. For 
example. vou might want to copy 4 chart from Excel and paste it 
into a Word document. 


To transfer Clipboard contents: 


[U Copy the information to the Clipboard using the Copy or Cut 
command from the Edit menu. 

[2] Hold down the Option key and click the Switcher arrow to 
switch to the other application. 
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Copying Worksheet Selections 


You can copy a picture of a worksheet selection to the Clipboard 
and then paste it into a Word document. A picture of a worksheet 
selection preserves all cell formats and worksheet properties, such 
as number formats, borders, and font display. 


To copy a worksheet selection: 





Select the Excel cells you want to copy. To copy a worksheet 
Hold down the Shift key. selection 

Choose Copy Picture from the Edit menu. 

Hold down the Option key as you click the Switcher arrow to 

move to Word. 

Select an insertion point in your Word document and choose 

Paste from the Edit menu. 
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The selection from your Excel worksheet is now included in your 
Word document, complete with number formats and borders. 


Note The worksheet selection is a “picture,” which you cannot 
edit. If you want to be able to change the values after they are 
copied to Word. use the procedure for copying values. 


Copying Charts 


You can copy a chart from Excel and paste it into a Word 
document. 
To copy a chart: 


[3] In Excel, choose Copy Chart from the Edit menu. To copy a chart 


[2] Click “As Shown on Screen” to set the size of the copy put in 
the Clipboard to be equal to the size on the screen. Click “As 
Shown When Printed” to set the size of the copy put in the 
Clipboard to be equal to the size of the printed chart. 


Click the OK button. 


Hold down the Option key as you click the Switcher arrow to 
move to Word. 


[e] [5] 


[z] 


Select an insertion point in vour Word document and choose 
Paste from the Edit menu. 


Your chart is now included as a picture in your Word document. 
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(2) Switch to any applications 
that are still installed, and 
quit them. 


After you have quit each 
application separately, you 


are ready to quit Switcher: 


[3] From the Switcher screen. 
choose Quit from the File 
menu. 


You can learn more about 

the Switcher screen, setting 
options, attaching documents, 
and allocating memory space 
from Switcher, a guide available 
from Apple or your Appie 
dealer. 


Important Never turn your Macintosh off to quit Switcher. Be 


sure you quit each application in 


Switcher screen. 


dividually and then quit from the 
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Internal Drive Disk External Drive Disk 
System folder Microsoft Word 
ImageWriter or LaserWriter Microsoft File 
document 


Switcher application 
Word/File document 


Transferring Information 


This section describes procedures for transferring information 
from File to Word, using the Clipboard. You can copy records 
from a File datafile to use as information in a Word document. 


To copy records: 


(1] In File, prepare the form so that the fields are in the order you TO copy records 
want. Then. from the Datafile window. select the records you 
want to copy and choose Copy from the Edit menu. 


[2] Hold down tbe Option key as you click the Switcher arrow to 
move to Word. 


[3] In Word. select an insertion point and choose Paste from the 
Edit menu. 


Your information from File is now included as text in vour Word 
document. If vou want to use the information in a merge docu- 
ment, prepare your header record as described in vour Word 
manual. 


you can transfer entire datafiles from File to Word if vou save 
them as text. Appendix D. “Using File with Other Applications,” 
in your Microsoft File manual explains: 


g How to use File datafile records as a merge document in 
Word. 


m How to use File report output in Word. 


Known Limitations 


Microsoft has tested Word with Switcher and has found these 
limitations: 


Option-Command-Shift-(period) Do not use this key sequence 
to select text from the insertion point to the bottom of a docu- 
ment. When Switcher is present, this sequence Causes an emer- 
gency exit from the program. 


apama r vallan ater 


14 Using Switcher with Microsoft Applications 


m. — . .. í. - 


Preferred memo 
size 


Minimum memory 
size 
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Known Limitations 


Microsoft has tested Excel with Switcher and has found no 
limitations. 


Preferred Memory Sizes 


If vou want to install a combination of Microsoft applications 
different from the ones described in this guide, you will need 
specific memory amounts for each application. 


You can change the amount of memory allocated to a particular 
application with Switcher's Configure Then Install command. See 
Apple's guide, Switcher, for details. 

The amount of memory Switcher first tries to allocate to Excel is 


the preferred memory size. Excel's preferred mernory size is 
berween 304K and 512K. You need enough mernory to load the 


entire application as well as sufficient space for printing and creat 


ing temporary files. 
When allocating memory for applications, you should always try 
to allocate as much memory as possible to Excel. Of course, with 


4 512K Macintosh, you won't be able to obtain the full 512K. But, 


if vou have a Lisa or a Macintosh XL with more than 512K of 
memory, you should allocate 512K. 


The smallest amount of memory Switcher will allocate to an appli- 


cation is the minimum memory size. Excel's minimum memory 
requirement is 256K. 


Microsoft Word 


Microsoft Word includes the Switcher program and a Switcher 
document named Word/File. If you have Microsoft File, you can 
use the Word/File document to include information from File 
datafiles in your Word documents. 


Setting Up Disks 


Copy your Word and File applications onto one disk that you use 
in the external drive. 


d 
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You can copy a portion of a Multiplan worksheet to use as a Chart 
data series. 


To copy information: 


[1] In Multiplan, select the cells you want to copy and choose 
Copy from the Edit menu. 


[2] Hold down the Option key as you click the Switcher arrow to 
move to Chart. 


[3] In Chart, select the New Series window and choose Paste from 
the Edit menu. 


Chart creates a series with your worksheet information following 
the rules in the section "Copying and Linking Data From Multiplan 
Worksheets" in "Using Chart,” in your Microsoft Chart manual. 


Known Limitations 


Microsoft has tested Multiplan with Switcher and has found this 
limitation: 

Large Clipboard In Multiplan versions 1.02 and earlier, if the 
information stored in your Clipboard is greater than 50 cells and 
you see the message "Save Formatted/Unformatted Values," you 
should paste into the Scrapbook before trying to paste into the 
other application. Clipboards storing more than 50 cells will not 
transfer to the other application. 


Preferred Memory Sizes 


If you want to install a combination of Microsoft applications 
different from the ones described in this guide, you will need 
specific memory amounts for each application. 


You can change the amount of memory allocated to a particular 
application with Switcher's Configure Then Install command. 


The amount of memory Switcher first tries to allocate to Multiplan 
is the preferred memory size. Multiplan's preferred memory size is 
160K. You need enough memory to load the entire application as 
well as sufficient space for printing and creating worksheets. 


The smallest amount of memory Switcher will allocate to an 
application is the minimum memory size. Multiplan’s minimum 


'memory requirement is 128k. 
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Preferred memory 
size 
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Minimum memo 
size 


Preferred Memory Sizes 


If you want to install a combination of Microsoft applications 
different from the ones described in this guide, you will need 
specific memory amounts for each application. 


You can change the amount of memory allocated to a particular 
application with Switcher's Configure Then Install command. 


The amount of memory Switcher first tries to allocate to File is 
the preferred memory size. File's preferred memory size is 288K. 
You need enough memory to load the entire application as well as 
sufficient space for printing and creating files and buffers. 


The smallest amount of memory Switcher will allocate to an appli- 
cation is the minimum memory size. File's minimum memory 
requirement is 128K. 


Microsoft Multiplan 


Microsoft Multiplan includes the Switcher program and a Switcher 
document named Multiplan/Chart. if you have Microsoft Chart, 
you can use the Multiplan/Chart document to Copy your Multiplan 
values to Chart. 


Setting Up Disks 


Copy your Multiplan and Chart applications onto 4 disk that you 
use in the external drive. 


Internal Drive Disk External Drive Disk 
System folder Microsoft Multiplan 
ImageWriter or LaserWriter Microsoft Chart 
document 


Switcher application 
Multiplan/Chart document 


Transterring Information 


This section describes procedures for transferring information 
from Multiptan to Chart, using the Clipboard. If you want to link a 
Multiplan worksheet tO 4 Chart document. see the section “Copy- 
ing and Linking Data From Multiplan Worksheets” in “Using 
Chart.” in vour Microsoft Chart manual. 


v 
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To copy information 


Microsoft Chart 


Microsoft Chart includes the Switcher program and a Switcher 
document named Chart/Word. If you have Microsoft Word, you 
can use the Char’ Word document to copy your charts to use as 


pictures in Word. j 


Setting Up Disks 


Copy your Chart and Word applications onto a disk that you use 
in the external drive. 


Internal Drive Disk External Drive Disk 
System folder Microsoft Chart 
ImageWriter or LaserWriter Microsoft Word 
document 


Switcher application 
Chart/Word document 


Transferring Information 


This section describes the procedure for transferring information 
from Chart to Word, using the Clipboard. Word reads data series 
from a chart as text and the chart itself as a picture. 


To copy information: 


[ In Chart, select the data series or the chart you want to copy 
and choose Copy from the Edit menu. If you want to copy 
both, you must copy them separately. 

[2] Hold down the Option key as you click the Switcher arrow to 
move to Word. 

[3] In Word, select an insertion point in a document and choose 
Paste from the Edit menu. 


Your data series or chart is now included as text or as a picture in 
your Word document. You can now edit the data series, but not 
the chart. 


vii i dis > : 
RATE Se: 
E o V. i4 


TL 


EUR 


